Sync with upstream @ 5b195795

1-js/01-getting-started/4-devtools/article.md

@@ -29,10 +29,15 @@ Dokładny widok narzędzi deweloperskich zależy od wersji Chrome'a. Narzędzia
 - Widzimy treść błędu zapisaną kolorem czerwonym. W tym przypadku skrypt zawiera nieznaną komendę "lalala".
 - Po prawej stronie jest klikalny link do źródła `bug.html:12`, z numerem linii kodu, w której błąd wystąpił.
 
-Poniżej treści błędu znajduje się niebieski symbol `>`. Oznacza linię, w której możemy pisać kod JavaScript. Naciśnij `key:Enter`, aby ten kod uruchomić (`key:Shift+Enter` dodaje nowy wiersz).
+Poniżej treści błędu znajduje się niebieski symbol `>`. Oznacza linię, w której możemy pisać kod JavaScript. Naciśnij `key:Enter`, aby ten kod uruchomić.
 
 Widzisz już komunikaty błędów i na początek powinno to wystarczyć. W rozdziale pt. "<info:debugging-chrome>" wrócimy do narzędzi deweloperskich, by poznać więcej tajników debuggowania.
 
+```smart header="Multi-line input"
+Usually, when we put a line of code into the console, and then press `key:Enter`, it executes.
+
+To insert multiple lines, press `key:Shift+Enter`. This way one can enter long fragments of JavaScript code.
+```
 
 ## Firefox, Edge i inne
 
@@ -50,12 +55,6 @@ Otwórz Preferencje i przejdź do zakładki "Zaawansowane". Zaznacz na samym dol
 
 Teraz, gdy naciśniesz `key:Cmd+Opt+C`, otworzysz konsolę. Warto dodać, że w górnym pasku menu pojawiła się nowa pozycja o nazwie "Programowanie". Ma w sobie wiele funkcji i opcji konfiguracyjnych.
 
-## Wpisywanie w wielu wierszach
-
-Zazwyczaj gdy wprowadzamy kod JavaScript w konsoli i naciśniemy klawisz `key:Enter`, wykona się on od razu.
-
-Aby wstawić kod, który ma kilka linii, wystarczy wcisnąć na końcu linii klawisz `key:Shift+Enter`, aby przejść do następnej.
-
 ## Podsumowanie
 
 - Narzędzia deweloperskie pozwalają podejrzeć błędy, uruchomić komendy javascriptowe, sprawdzać zmienne i wiele, wiele innych.

1-js/02-first-steps/05-types/article.md

@@ -10,7 +10,7 @@ message = 123456;
 
 Część języków programowania stosuje tak zwane "dynamiczne typowanie", które oznacza, że typy danych zmiennych mogą zmienić się w trakcie działania programu.
 
-Wyróżniamy 7 podstawowych typów danych w JavaScripcie. Przedstawimy je teraz ogólnie, w następnych rozdziałach omówimy bardziej szczegółowo.
+Wyróżniamy 8 podstawowych typów danych w JavaScripcie. Przedstawimy je teraz ogólnie, w następnych rozdziałach omówimy bardziej szczegółowo.
 
 ## Typ liczbowy
 
@@ -62,14 +62,33 @@ Specjalne wartości liczbowe formalnie należą do typu "liczbowego". Oczywiści
 
 Więcej informacji o pracy z liczbami zawarte jest w rozdziale pt. "<info:number>".
 
+## BigInt
+
+W JavaScripcie typ liczbowy nie może reprezentować liczb całkowitych większych od <code>2<sup>53</sup></code> (ani ujemnych mniejszych od <code>-2<sup>53</sup></code>) ze względu na ograniczenia techniczne narzucone przez jego reprezentację wewnętrzną. Daje to liczby o długości około 16 cyfr, co w większości przypadków wystarcza. Jednak czasami potrzebujemy skorzystać z naprawdę dużych liczb, np. w krytografii czy znaczników czasowych z dokładnością do mikrosekund.
+
+Typ `BigInt` został niedawno dodany do języka i reprezentuje liczby całkowite o dowolnej długości.
+
+`BigInt` tworzy się poprzez dodanie `n` na końcu liczby:
+
+```js
+// "n" na końcu oznacza, że to liczba typu BigInt
+const bigInt = 1234567890123456789012345678901234567890n;
+```
+
+Z racji tego, że liczby typu `BigInt` są rzadko stosowane, poświęciliśmy im osobny rozdział pt. "<info:bigint>".
+
+```smart header="Problemy z kompatybilnością"
+Aktualnie dla typu `BigInt` wsparcie posiadają przeglądarki Firefox i Chrome. Brakuje go w Safari/IE/Edge.
+```
+
 ## Typ tekstowy
 
 Ciąg znaków (ang. *string*), zwany także "literałem znakowym" lub "napisem", to typ tekstowy, który zapisujemy przy użyciu cudzysłowów.
 
 ```js
 let str = "Witaj";
 let str2 = 'Można użyć także apostrofów';
-let phrase = `Można dołączyć zmienną ${str}`;
+let phrase = `Można dołączyć dodatkową zmienną ${str}`;
 ```
 
 W JavaScripcie istnieją 3 typy cudzysłowów.
@@ -78,7 +97,7 @@ W JavaScripcie istnieją 3 typy cudzysłowów.
 2. Apostrofy: `'Witaj'`.
 3. Grawisy (ang. *backtick*): <code>&#96;Witaj&#96;</code>.
 
-W JavaScripcie nie ma różnicy między cudzysłowami a apostrofami.
+Pojedyncze i podwójne cudzysłowy są cudzysłowami prostymi. W JavaScripcie nie ma między nimi żadnej różnicy.
 
 Grawisy są "rozszerzeniem funkcjonalności" zwykłych apostrofów i cudzysłowów. Pozwalają na dodanie zmiennej i wyrażeń do ciągu znaków poprzez umieszczenie ich wewnątrz `${…}`, przykładowo:
 
@@ -102,12 +121,12 @@ alert( "Wynik to ${1 + 2}" ); // Wynik to ${1 + 2} (cudzysłów traktuje ${…}
 Więcej o ciągach znaków można przeczytać w rozdziale pt. "<info:string>".
 
 ```smart header="JavaScript nie posiada typu *znakowego*."
-W niektórych językach istnieje specjalny typ "znakowy", używany do przechowywania pojedynczych znaków. Przykładowo, w językach C i Java możemy użyć typu `char`.
+W niektórych językach istnieje specjalny typ "znakowy", używany do przechowywania pojedynczych znaków. Przykładowo, w językach C i Java możemy użyć typu o nazwie "char".
 
 W JavaScripcie nie ma takiego typu. Mamy do dyspozycji jedynie `string`. Ciąg znaków może być pusty albo zawierać jeden i więcej znaków.
 ```
 
-## Typ logiczny
+## Typ logiczny (boolean)
 
 Typ logiczny (ang. *boolean*) posiada dwie wartości: `true` (prawda) lub `false` (fałsz).
 
@@ -198,6 +217,8 @@ typeof undefined // "undefined"
 
 typeof 0 // "number"
 
+typeof 10n // "bigint"
+
 typeof true // "boolean"
 
 typeof "coś" // "string"
@@ -226,9 +247,10 @@ Ostatnie trzy linijki wymagają dodatkowego wyjaśnienia.
 
 ## Podsumowanie
 
-W JavaScripcie wyróżniamy 7 podstawowych typów danych.
+W JavaScripcie wyróżniamy 8 podstawowych typów danych.
 
 - `number` dla wszystkich liczb: całkowitych lub zmiennoprzecinkowych.
+- `bigint` dla liczb całkowitych o dowolnej długości.
 - `string` dla ciągów znaków. Może być pusty albo zawierać jeden czy więcej znaków; nie ma oddzielnego typu dla pojedynczego znaku.
 - `boolean` dla `true`/`false` (prawda/fałsz).
 - `null` dla pustych wartości -- autonomiczny typ, który posiada jedną wartość: `null`.

1-js/02-first-steps/06-type-conversions/article.md

@@ -80,18 +80,7 @@ alert( Number(false) );       // 0
 
 Zauważ, że `null` i `undefined` zachowują się inaczej. `null` jest konwertowany do zera, a `undefined` do `NaN`.
 
-````smart header="Operator '+' łączy ciągi znaków"
-Większość operacji matematycznych rzutuje wartości do typu liczbowego. Jedynym wyjątkiem jest `+`. Jeśli jedna z dodawanych wartości będzie typu tekstowego, druga również jest rzutowana do typu tekstowego.
-
-Wtedy następuje ich konkatenacja (połączenie):
-
-```js run
-alert( 1 + '2' ); // '12' (tekst po prawej)
-alert( '1' + 2 ); // '12' (tekst po lewej)
-```
-
-Dzieje się tak w sytuacji, gdy przynajmniej jeden z argumentów jest typu tekstowego. W przeciwnym wypadku wartości są rzutowane na typ liczbowy.
-````
+Większość operatorów matematycznych także wykonuje taką konwersję. Więcej na ten temat dowiesz się z kolejnego rozdziału.
 
 ## Rzutowanie do typu logicznego
 

1-js/02-first-steps/08-comparison/1-comparison-questions/solution.md

@@ -13,7 +13,7 @@ null === +"\n0\n" → false
 Some of the reasons:
 
 1. Obviously, true.
-2. Dictionary comparison, hence false.
+2. Dictionary comparison, hence false. `"a"` is smaller than `"p"`.
 3. Again, dictionary comparison, first char of `"2"` is greater than the first char of `"1"`.
 4. Values `null` and `undefined` equal each other only.
 5. Strict equality is strict. Different types from both sides lead to false.