From a87efc0930f3c467e0f0c1bdf966c7da26ec1f54 Mon Sep 17 00:00:00 2001 From: Nikolay Gagarinov Date: Wed, 10 Jun 2026 17:03:31 +0500 Subject: [PATCH 1/2] fix(35-calling-functions): explain Math object and docs reading (T01) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Добавлено объяснение объекта Math и раздел «Как узнавать о новых функциях» в урок 35/100-call. В урок 33/55-data-types-casting добавлена оговорка о том, что вызовы функций разбираются в следующем модуле. T01 из docs/python-alignment-javascript (AUDIT.md, P1-1) Co-Authored-By: Claude Fable 5 --- .../55-data-types-casting/ru/README.md | 2 ++ .../100-call/ru/README.md | 25 +++++++++++++++++++ 2 files changed, 27 insertions(+) diff --git a/modules/33-data-types/55-data-types-casting/ru/README.md b/modules/33-data-types/55-data-types-casting/ru/README.md index ad5d4ffa..e681c458 100644 --- a/modules/33-data-types/55-data-types-casting/ru/README.md +++ b/modules/33-data-types/55-data-types-casting/ru/README.md @@ -56,6 +56,8 @@ console.log(Boolean(1)); // => true ## Отбрасывание дробной части с помощью Math.trunc() +`Math.trunc()` — встроенная функция; вызовы функций подробно разбираются в следующем модуле, пока достаточно использовать её по образцу из примера. + Иногда из дробного числа нужно получить целое, отбросив дробную часть. Для этого используют `Math.trunc()`: ```javascript diff --git a/modules/35-calling-functions/100-call/ru/README.md b/modules/35-calling-functions/100-call/ru/README.md index 7f3a30db..7aae917a 100644 --- a/modules/35-calling-functions/100-call/ru/README.md +++ b/modules/35-calling-functions/100-call/ru/README.md @@ -96,6 +96,31 @@ console.log(Math.pow(5, 2)); // => 25 По структуре вызов с несколькими аргументами не отличается от вызова с одним: то же имя функции, скобки и аргументы через запятую. +`Math` — встроенный в JavaScript набор функций для работы с числами. Он доступен из любого места программы. Запись `Math.pow(...)` пока можно читать как «длинное имя функции»: приставка `Math.` говорит о том, что функция принадлежит этому набору. Что на самом деле означает точка — разберём в уроках про объекты. На поведение функции это никак не влияет. + +Полный список математических функций доступен в [документации MDN](https://developer.mozilla.org/ru/docs/Web/JavaScript/Reference/Global_Objects/Math). + +## Как узнавать о новых функциях + +У каждой функции есть **сигнатура** — её «описание»: имя, список параметров и тип возвращаемого значения. Именно сигнатура позволяет понять, как пользоваться функцией, не читая её код. Например, документация MDN описывает `Math.pow()` так: + +``` +Math.pow(base, exponent) + +Параметры + base — основание степени + exponent — показатель степени +``` + +Из сигнатуры сразу видно: функция принимает два аргумента и возвращает число. Научившись читать сигнатуры, можно работать с любой незнакомой функцией. + +Всё выучить невозможно — это не нужно. Важно знать, где искать. Для JavaScript есть два основных источника: + +- **MDN** ([developer.mozilla.org](https://developer.mozilla.org/ru/)) — документация по встроенным возможностям языка и браузерным API. +- **Документация Node.js** ([nodejs.org/api](https://nodejs.org/api/)) — серверная часть, функции для работы с файловой системой, сетью и т. д. + +Ещё один способ — читать чужой код: любой пакет на npm открыт, и в нём часто можно найти приёмы, о которых не написано в учебниках. + ## Параметры и аргументы В разговорах о функциях встречаются слова **параметры** и **аргументы**. Они связаны, но это не одно и то же. From bf2c5645e22a53d0a7c3749c4e4d1f1c5ea413b8 Mon Sep 17 00:00:00 2001 From: Nikolay Gagarinov Date: Wed, 10 Jun 2026 17:10:15 +0500 Subject: [PATCH 2/2] fix(100-call): move docs-reading section to the end of the lesson Co-Authored-By: Claude Fable 5 --- .../100-call/ru/README.md | 32 +++++++++---------- 1 file changed, 16 insertions(+), 16 deletions(-) diff --git a/modules/35-calling-functions/100-call/ru/README.md b/modules/35-calling-functions/100-call/ru/README.md index 7aae917a..5dffbfe6 100644 --- a/modules/35-calling-functions/100-call/ru/README.md +++ b/modules/35-calling-functions/100-call/ru/README.md @@ -100,6 +100,22 @@ console.log(Math.pow(5, 2)); // => 25 Полный список математических функций доступен в [документации MDN](https://developer.mozilla.org/ru/docs/Web/JavaScript/Reference/Global_Objects/Math). +## Параметры и аргументы + +В разговорах о функциях встречаются слова **параметры** и **аргументы**. Они связаны, но это не одно и то же. + +О **параметрах** говорят при создании функции — это переменные внутри функции, в которые попадают переданные значения. Об **аргументах** говорят при вызове — это то, что мы передаём в функцию. Аргументом может быть число, переменная или любое выражение: + +```javascript +console.log(Math.pow(2, 3)); // => 8, аргументы — числа + +const x = 2; +// аргумент может быть выражением, оно вычислится до передачи +console.log(Math.pow(x + 1, 3)); // => 27 +``` + +Запоминать это не обязательно, но пригодится при чтении англоязычной литературы. + ## Как узнавать о новых функциях У каждой функции есть **сигнатура** — её «описание»: имя, список параметров и тип возвращаемого значения. Именно сигнатура позволяет понять, как пользоваться функцией, не читая её код. Например, документация MDN описывает `Math.pow()` так: @@ -120,19 +136,3 @@ Math.pow(base, exponent) - **Документация Node.js** ([nodejs.org/api](https://nodejs.org/api/)) — серверная часть, функции для работы с файловой системой, сетью и т. д. Ещё один способ — читать чужой код: любой пакет на npm открыт, и в нём часто можно найти приёмы, о которых не написано в учебниках. - -## Параметры и аргументы - -В разговорах о функциях встречаются слова **параметры** и **аргументы**. Они связаны, но это не одно и то же. - -О **параметрах** говорят при создании функции — это переменные внутри функции, в которые попадают переданные значения. Об **аргументах** говорят при вызове — это то, что мы передаём в функцию. Аргументом может быть число, переменная или любое выражение: - -```javascript -console.log(Math.pow(2, 3)); // => 8, аргументы — числа - -const x = 2; -// аргумент может быть выражением, оно вычислится до передачи -console.log(Math.pow(x + 1, 3)); // => 27 -``` - -Запоминать это не обязательно, но пригодится при чтении англоязычной литературы.