You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: 1-js/02-first-steps/01-hello-world/article.md
+1-1
Original file line number
Diff line number
Diff line change
@@ -47,7 +47,7 @@ The `<script>` tag has a few attributes that are rarely used nowadays, but we ca
47
47
48
48
The `type` attribute: <code><script <u>type</u>=...></code>
49
49
50
-
: The old standard HTML4 required a script to have a type. Usually it was `type="text/javascript"`. The modern HTML standard assumes this `type` by default. No attribute is required.
50
+
: The old standard HTML4 required a script to have a type. Usually it was `type="text/javascript"`. It's not required any more. Also, the modern standard totally changed the meaning of this attribute. Now it can be used for Javascript modules. But that's an advanced topic, but we'll talk about modules later in another part of the tutorial.
51
51
52
52
The `language` attribute: <code><script <u>language</u>=...></code>
53
53
: This attribute was meant to show the language of the script. As of now, this attribute makes no sense, the language is JavaScript by default. No need to use it.
Copy file name to clipboardExpand all lines: 1-js/03-code-quality/04-ninja-code/article.md
+6-6
Original file line number
Diff line number
Diff line change
@@ -34,7 +34,7 @@ i = i ? i < 0 ? Math.max(0, len + i) : i : 0;
34
34
35
35
Cool, right? If you write like that, the developer who comes across this line and tries to understand what is the value of `i` is going to have a merry time. Then come to you, seeking for an answer.
36
36
37
-
Tell him that shorter is always better. Initiate him into the paths of ninja.
37
+
Tell them that shorter is always better. Initiate them into the paths of ninja.
38
38
39
39
## One-letter variables
40
40
@@ -45,11 +45,11 @@ completed.
45
45
46
46
Another way to code faster is to use single-letter variable names everywhere. Like `a`, `b` or `c`.
47
47
48
-
A short variable disappears in the code like a real ninja in the forest. No one will be able to find it using "search" of the editor. And even if someone does, he won't be able to "decipher" what the name `a` or `b` means.
48
+
A short variable disappears in the code like a real ninja in the forest. No one will be able to find it using "search" of the editor. And even if someone does, they won't be able to "decipher" what the name `a` or `b` means.
49
49
50
50
...But there's an exception. A real ninja will never use `i` as the counter in a `"for"` loop. Anywhere, but not here. Look around, there are many more exotic letters. For instance, `x` or `y`.
51
51
52
-
An exotic variable as a loop counter is especially cool if the loop body takes 1-2 pages (make it longer if you can). Then if someone looks deep inside the loop, he won't be able to quickly figure out that the variable named `x` is the loop counter.
52
+
An exotic variable as a loop counter is especially cool if the loop body takes 1-2 pages (make it longer if you can). Then if someone looks deep inside the loop, they won't be able to quickly figure out that the variable named `x` is the loop counter.
53
53
54
54
## Use abbreviations
55
55
@@ -153,7 +153,7 @@ function ninjaFunction(elem) {
153
153
}
154
154
```
155
155
156
-
A fellow programmer who wants to work with `elem` in the second half of the function will be surprised... Only during the debugging, after examining the code he will find out that he's working with a clone!
156
+
A fellow programmer who wants to work with `elem` in the second half of the function will be surprised... Only during the debugging, after examining the code they will find out that he's working with a clone!
157
157
158
158
Deadly effective even against an experienced ninja. Seen in code regularly.
159
159
@@ -204,7 +204,7 @@ There are functions that look like they don't change anything. Like `isReady()`,
204
204
205
205
**A really beautiful trick is to add a "useful" action to them, besides the main task.**
206
206
207
-
The expression of dazed surprise on the face of your colleague when he sees a function named `is..`, `check..` or `find...` changing something -- will definitely broaden your boundaries of reason.
207
+
The expression of dazed surprise on the face of your colleague when they see a function named `is..`, `check..` or `find...` changing something -- will definitely broaden your boundaries of reason.
208
208
209
209
**Another way to surprise is to return a non-standard result.**
210
210
@@ -228,7 +228,7 @@ Additional actions should not be obvious from the function name. A true ninja co
228
228
229
229
**Joining several actions into one protects your code from reuse.**
230
230
231
-
Imagine, another developer wants only to check the email, and not output any message. Your function `validateEmail(email)` that does both will not suit him. So he won't break your meditation by asking anything about it.
231
+
Imagine, another developer wants only to check the email, and not output any message. Your function `validateEmail(email)` that does both will not suit them. So they won't break your meditation by asking anything about it.
Copy file name to clipboardExpand all lines: 1-js/03-code-quality/06-polyfills/article.md
+1-1
Original file line number
Diff line number
Diff line change
@@ -19,7 +19,7 @@ Here Babel comes to the rescue.
19
19
20
20
Actually, there are two parts in Babel:
21
21
22
-
1. First, the transpiler program, which rewrites the code. The developer runs it on his own computer. It rewrites the code into the older standard. And then the code is delivered to the website for users. Modern project build system like [webpack](http://webpack.github.io/) or [brunch](http://brunch.io/) provide means to run transpiler automatically on every code change, so that doesn't involve any time loss from our side.
22
+
1. First, the transpiler program, which rewrites the code. The developer runs it on their own computer. It rewrites the code into the older standard. And then the code is delivered to the website for users. Modern project build system like [webpack](http://webpack.github.io/) or [brunch](http://brunch.io/) provide means to run transpiler automatically on every code change, so that doesn't involve any time loss from our side.
Copy file name to clipboardExpand all lines: 1-js/05-data-types/02-number/article.md
+1-1
Original file line number
Diff line number
Diff line change
@@ -201,7 +201,7 @@ Strange! What is it then if not `0.3`?
201
201
alert( 0.1 + 0.2 ); // 0.30000000000000004
202
202
```
203
203
204
-
Ouch! There are more consequences than an incorrect comparison here. Imagine you're making an e-shopping site and the visitor puts `$0.10` and `$0.20` goods into his chart. The order total will be `$0.30000000000000004`. That would surprise anyone.
204
+
Ouch! There are more consequences than an incorrect comparison here. Imagine you're making an e-shopping site and the visitor puts `$0.10` and `$0.20` goods into their chart. The order total will be `$0.30000000000000004`. That would surprise anyone.
Copy file name to clipboardExpand all lines: 1-js/05-data-types/03-string/article.md
+1-1
Original file line number
Diff line number
Diff line change
@@ -451,7 +451,7 @@ Let's recap these methods to avoid any confusion:
451
451
```smart header="Which one to choose?"
452
452
All of them can do the job. Formally, `substr` has a minor drawback: it is described not in the core JavaScript specification, but in Annex B, which covers browser-only features that exist mainly for historical reasons. So, non-browser environments may fail to support it. But in practice it works everywhere.
453
453
454
-
The author finds himself using `slice` almost all the time.
454
+
The author finds themself using `slice` almost all the time.
Copy file name to clipboardExpand all lines: 1-js/05-data-types/07-map-set-weakmap-weakset/article.md
+2-2
Original file line number
Diff line number
Diff line change
@@ -47,7 +47,7 @@ For instance:
47
47
```js run
48
48
let john = { name:"John" };
49
49
50
-
// for every user, let's store his visits count
50
+
// for every user, let's store their visits count
51
51
let visitsCountMap =newMap();
52
52
53
53
// john is the key for the map
@@ -332,7 +332,7 @@ That's useful for situations when we have a main storage for the objects somewhe
332
332
333
333
Let's look at an example.
334
334
335
-
For instance, we have code that keeps a visit count for each user. The information is stored in a map: a user is the key and the visit count is the value. When a user leaves, we don't want to store his visit count anymore.
335
+
For instance, we have code that keeps a visit count for each user. The information is stored in a map: a user is the key and the visit count is the value. When a user leaves, we don't want to store their visit count anymore.
336
336
337
337
One way would be to keep track of leaving users and clean up the storage manually:
Copy file name to clipboardExpand all lines: 1-js/06-advanced-functions/09-call-apply-decorators/04-throttle/task.md
+1-1
Original file line number
Diff line number
Diff line change
@@ -22,7 +22,7 @@ So we'll assign `throttle(update, 100)` as the function to run on each mouse mov
22
22
23
23
Visually, it will look like this:
24
24
25
-
1. For the first mouse movement the decorated variant passes the call to `update`. That's important, the user sees our reaction to his move immediately.
25
+
1. For the first mouse movement the decorated variant passes the call to `update`. That's important, the user sees our reaction to their move immediately.
26
26
2. Then as the mouse moves on, until `100ms` nothing happens. The decorated variant ignores calls.
27
27
3. At the end of `100ms` -- one more `update` happens with the last coordinates.
28
28
4. Then, finally, the mouse stops somewhere. The decorated variant waits until `100ms` expire and then runs `update` runs with last coordinates. So, perhaps the most important, the final mouse coordinates are processed.
Copy file name to clipboardExpand all lines: 1-js/08-error-handling/1-try-catch/article.md
+2-2
Original file line number
Diff line number
Diff line change
@@ -194,7 +194,7 @@ You can find more detailed information about JSON in the <info:json> chapter.
194
194
195
195
Should we be satisfied with that? Of course, not!
196
196
197
-
This way, if something's wrong with the data, the visitor will never know that (unless he opens developer console). And people really don't like when something "just dies" without any error message.
197
+
This way, if something's wrong with the data, the visitor will never know that (unless they open the developer console). And people really don't like when something "just dies" without any error message.
198
198
199
199
Let's use `try..catch` to handle the error:
200
200
@@ -575,7 +575,7 @@ The information from this section is not a part of the core JavaScript.
575
575
576
576
Let's imagine we've got a fatal error outside of `try..catch`, and the script died. Like a programming error or something else terrible.
577
577
578
-
Is there a way to react on such occurrences? We may want to log the error, show something to the user (normally he doesn't see error messages) etc.
578
+
Is there a way to react on such occurrences? We may want to log the error, show something to the user (normally they don't see error messages) etc.
579
579
580
580
There is none in the specification, but environments usually provide it, because it's really useful. For instance, Node.JS has [process.on('uncaughtException')](https://nodejs.org/api/process.html#process_event_uncaughtexception) for that. And in the browser we can assign a function to special [window.onerror](mdn:api/GlobalEventHandlers/onerror) property. It will run in case of an uncaught error.
Copy file name to clipboardExpand all lines: 2-ui/3-event-details/1-mouse-events-basics/article.md
+1-1
Original file line number
Diff line number
Diff line change
@@ -175,7 +175,7 @@ Now if you double-click on "Unselectable", it doesn't get selected. Seems to wor
175
175
176
176
...But there is a potential problem! The text became truly unselectable. Even if a user starts the selection from "Before" and ends with "After", the selection skips "Unselectable" part. Do we really want to make our text unselectable?
177
177
178
-
Most of time, we don't. A user may have valid reasons to select the text, for copying or other needs. That may be inconvenient if we don't allow him to do it. So this solution is not that good.
178
+
Most of time, we don't. A user may have valid reasons to select the text, for copying or other needs. That may be inconvenient if we don't allow them to do it. So this solution is not that good.
179
179
180
180
What we want is to prevent the selection on double-click, that's it.
Copy file name to clipboardExpand all lines: 2-ui/3-event-details/3-mousemove-mouseover-mouseout-mouseenter-mouseleave/2-hoverintent/task.md
+1-1
Original file line number
Diff line number
Diff line change
@@ -6,7 +6,7 @@ importance: 5
6
6
7
7
Write a function that shows a tooltip over an element only if the visitor moves the mouse *over it*, but not *through it*.
8
8
9
-
In other words, if the visitor moves the mouse on the element and stopped -- show the tooltip. And if he just moved the mouse through fast, then no need, who wants extra blinking?
9
+
In other words, if the visitor moves the mouse on the element and stopped -- show the tooltip. And if they just moved the mouse through fast, then no need, who wants extra blinking?
10
10
11
11
Technically, we can measure the mouse speed over the element, and if it's slow then we assume that it comes "over the element" and show the tooltip, if it's fast -- then we ignore it.
Copy file name to clipboardExpand all lines: 4-frames-and-windows/01-popup-windows/article.md
+1-1
Original file line number
Diff line number
Diff line change
@@ -176,7 +176,7 @@ Still, there are some things that can be done.
176
176
For instance:
177
177
178
178
- When we open a popup, it's might be a good idea to run a `newWindow.focus()` on it. Just in case, for some OS/browser combinations it ensures that the user is in the new window now.
179
-
- If we want to track when a visitor actually uses our web-app, we can track `window.onfocus/onblur`. That allows us to suspend/resume in-page activities, animations etc. But please note that the `blur` event means that the visitor switched out from the window, but he still may observe it. The window is in the background, but still may be visible.
179
+
- If we want to track when a visitor actually uses our web-app, we can track `window.onfocus/onblur`. That allows us to suspend/resume in-page activities, animations etc. But please note that the `blur` event means that the visitor switched out from the window, but they still may observe it. The window is in the background, but still may be visible.
0 commit comments