Skip to content

Commit 1073304

Browse files
authored
feat: first lesson about DevTools (#1316)
Porting [this lesson](https://docs.apify.com/academy/web-scraping-for-beginners/data-extraction/browser-devtools). I thought I'll do minimal changes, but I couldn't resist: - I tried to unify the style with the rest of the course. I wrote the stuff with my own words, and added standard polishing I usually do (dictionary, proofreading by AI, etc.) - I explained HTML, CSS, and JavaScript a bit. That should serve as a minimal replacement for [this page](https://docs.apify.com/academy/web-scraping-for-beginners/data-extraction) - I added several screenshots. - I added exercises. - I'm intentionally removing references to Firefox (albeit it's my primary browser and I love it 😭), because students shouldn't be given choices in tutorial-style texts. The references felt like distractions. ![image](https://github.com/user-attachments/assets/779c4e22-14e2-44c1-a636-416615e8c99e)
1 parent c1422f9 commit 1073304

10 files changed

+161
-7
lines changed

sources/academy/webscraping/scraping_basics_python/01_devtools_inspecting.md

Lines changed: 161 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -6,18 +6,172 @@ sidebar_position: 1
66
slug: /scraping-basics-python/devtools-inspecting
77
---
88

9+
import Exercises from './_exercises.mdx';
10+
911
**In this lesson we'll use the browser tools for developers to inspect and manipulate the structure of an e-commerce website.**
1012

1113
---
1214

13-
:::danger Work in Progress
15+
A browser is the most complete tool for navigating websites. Scrapers are like automated browsers—and sometimes, they actually are automated browsers. The key difference? There's no user to decide where to go or eyes to see what's displayed. Everything has to be pre-programmed.
16+
17+
All modern browsers provide developer tools, or DevTools, for website developers to debug their work. We'll use them to understand how websites are structured and identify the behavior our scraper needs to mimic. Here's the typical workflow for creating a scraper:
18+
19+
1. Inspect the target website in DevTools to understand its structure and determine how to extract the required data.
20+
1. Translate those findings into code.
21+
1. If the scraper fails due to overlooked edge cases or, over time, due to website changes, go back to step 1.
22+
23+
Now let's spend some time figuring out what the detective work from step 1 is about.
24+
25+
## Opening DevTools
26+
27+
Google Chrome is currently the most popular browser, and many others use the same core. That's why we'll focus on [Chrome DevTools](https://developer.chrome.com/docs/devtools) here. However, the steps are similar in other browsers like Safari ([Web Inspector](https://developer.apple.com/documentation/safari-developer-tools/web-inspector)) or Firefox ([DevTools](https://firefox-source-docs.mozilla.org/devtools-user/)).
28+
29+
Let's peek behind the scenes of a real-world website—say, Wikipedia. Open Google Chrome and visit [wikipedia.org](https://www.wikipedia.org/). Press **F12**, or right-click anywhere on the page and select **Inspect**.
30+
31+
![Wikipedia with Chrome DevTools open](./images/devtools-wikipedia.png)
1432

15-
This lesson is under development. Please read [Starting with browser DevTools](../scraping_basics_javascript/data_extraction/browser_devtools.md) in the meantime so you can follow the upcoming lessons.
33+
Websites are built with three main technologies: HTML, CSS, and JavaScript. In the **Elements** tab, DevTools shows the HTML and CSS of the current page:
34+
35+
![Elements tab in Chrome DevTools](./images/devtools-elements-tab.png)
36+
37+
:::warning Screen adaptations
38+
39+
On smaller or low-resolution screens, DevTools might look different. For example, the CSS styles section might appear below the HTML elements instead of in the right pane.
1640

1741
:::
1842

19-
<!--
20-
https://developer.chrome.com/docs/devtools/
21-
https://firefox-dev.tools/
22-
https://developer.apple.com/documentation/safari-developer-tools/web-inspector
23-
-->
43+
Think of [HTML](https://developer.mozilla.org/en-US/docs/Learn/HTML) as the frame that defines a page's structure. A basic HTML element includes an opening tag, a closing tag, and attributes. Here's an `article` element with an `id` attribute. It wraps `h1` and `p` elements, both containing text. Some text is emphasized using `em`.
44+
45+
```html
46+
<article id="article-123">
47+
<h1 class="heading">First Level Heading</h1>
48+
<p>Paragraph with <em>emphasized text</em>.</p>
49+
</article>
50+
```
51+
52+
HTML, a markup language, describes how everything on a page is organized, how elements relate to each other, and what they mean. It doesn't define how elements should look—that's where [CSS](https://developer.mozilla.org/en-US/docs/Learn/CSS) comes in. CSS is like the velvet covering the frame. Using styles, we can select elements and assign rules that tell the browser how they should appear. For instance, we can style all elements with `heading` in their `class` attribute to make the text blue and uppercase.
53+
54+
```css
55+
.heading {
56+
color: blue;
57+
text-transform: uppercase;
58+
}
59+
```
60+
61+
While HTML and CSS describe what the browser should display, [JavaScript](https://developer.mozilla.org/en-US/docs/Learn/JavaScript) is a general-purpose programming language that adds interaction to the page.
62+
63+
In DevTools, the **Console** tab allows ad-hoc experimenting with JavaScript. If you don't see it, press **ESC** to toggle the Console. Running commands in the Console lets you manipulate the loaded page—we’ll try this shortly.
64+
65+
![Console in Chrome DevTools](./images/devtools-console.png)
66+
67+
## Selecting an element
68+
69+
In the top-left corner of DevTools, find the icon with an arrow pointing to a square.
70+
71+
![Chrome DevTools element selection tool](./images/devtools-element-selection.png)
72+
73+
Click the icon and hover your cursor over Wikipedia's subtitle, **The Free Encyclopedia**. As you move your cursor, DevTools will display information about the HTML element under it. Click on the subtitle. In the **Elements** tab, DevTools will highlight the HTML element that represents the subtitle.
74+
75+
![Chrome DevTools element hover](./images/devtools-hover.png)
76+
77+
The highlighted section should look something like this:
78+
79+
```html
80+
<strong class="jsl10n localized-slogan" data-jsl10n="portal.slogan">
81+
The Free Encyclopedia
82+
</strong>
83+
```
84+
85+
If we were experienced creators of scrapers, our eyes would immediately spot what's needed to make a program that fetches Wikipedia's subtitle. The program would need to download the page's source code, find a `strong` element with `localized-slogan` in its `class` attribute, and extract its text.
86+
87+
:::tip HTML and whitespace
88+
89+
In HTML, whitespace isn't significant, i.e., it only makes the code readable. The following code snippets are equivalent:
90+
91+
```html
92+
<strong>
93+
The Free Encyclopedia
94+
</strong>
95+
```
96+
97+
```html
98+
<strong>The Free
99+
Encyclopedia
100+
</strong>
101+
```
102+
103+
:::
104+
105+
## Interacting with an element
106+
107+
We won't be creating Python scrapers just yet. Let's first get familiar with what we can do in the JavaScript console and how we can further interact with HTML elements on the page.
108+
109+
In the **Elements** tab, with the subtitle element highlighted, right-click the element to open the context menu. There, choose **Store as global variable**. The **Console** should appear, with a `temp1` variable ready.
110+
111+
![Global variable in Chrome DevTools Console](./images/devtools-console-variable.png)
112+
113+
The Console allows us to run JavaScript in the context of the loaded page, similar to Python's [interactive REPL](https://realpython.com/interacting-with-python/). We can use it to play around with elements.
114+
115+
For a start, let's access some of the subtitle's properties. One such property is `textContent`, which contains the text inside the HTML element. The last line in the Console is where your cursor is. Type the following and hit **Enter**:
116+
117+
```js
118+
temp1.textContent;
119+
```
120+
121+
The result should be `'The Free Encyclopedia'`. Now try this:
122+
123+
```js
124+
temp1.outerHTML;
125+
```
126+
127+
This should return the element's HTML tag as a string. Finally, run the next line to change the text of the element:
128+
129+
```js
130+
temp1.textContent = 'Hello World!';
131+
```
132+
133+
When you change elements in the Console, those changes reflect immediately on the page!
134+
135+
![Changing textContent in Chrome DevTools Console](./images/devtools-console-textcontent.png)
136+
137+
But don't worry—you haven't hacked Wikipedia. The change only happens in your browser. If you reload the page, your change will disappear. This, however, is an easy way to craft a screenshot with fake content—so screenshots shouldn't be trusted as evidence.
138+
139+
We're not here for playing around with elements, though—we want to create a scraper for an e-commerce website to watch prices. In the next lesson, we'll examine the website and use CSS selectors to locate HTML elements containing the data we need.
140+
141+
---
142+
143+
<Exercises />
144+
145+
### Find FIFA logo
146+
147+
Open the [FIFA website](https://www.fifa.com/) and use the DevTools to figure out the URL of FIFA's logo image file. Hint: You're looking for an [`img`](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/img) element with a `src` attribute.
148+
149+
<details>
150+
<summary>Solution</summary>
151+
152+
1. Go to [fifa.com](https://www.fifa.com/).
153+
1. Activate the element selection tool.
154+
1. Click on the logo.
155+
1. Send the highlighted element to the **Console** using the **Store as global variable** option from the context menu.
156+
1. In the console, type `temp1.src` and hit **Enter**.
157+
158+
![DevTools exercise result](./images/devtools-exercise-fifa.png)
159+
160+
</details>
161+
162+
### Make your own news
163+
164+
Open a news website, such as [CNN](https://cnn.com). Use the Console to change the headings of some articles.
165+
166+
<details>
167+
<summary>Solution</summary>
168+
169+
1. Go to [cnn.com](https://cnn.com).
170+
1. Activate the element selection tool.
171+
1. Click on a heading.
172+
1. Send the highlighted element to the **Console** using the **Store as global variable** option from the context menu.
173+
1. In the console, type `temp1.textContent = 'Something something'` and hit **Enter**.
174+
175+
![DevTools exercise result](./images/devtools-exercise-cnn.png)
176+
177+
</details>
303 KB
Loading
48.6 KB
Loading
126 KB
Loading
142 KB
Loading
281 KB
Loading
327 KB
Loading
753 KB
Loading
234 KB
Loading
684 KB
Loading

0 commit comments

Comments
 (0)