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..5dffbfe6 100644 --- a/modules/35-calling-functions/100-call/ru/README.md +++ b/modules/35-calling-functions/100-call/ru/README.md @@ -96,6 +96,10 @@ 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). + ## Параметры и аргументы В разговорах о функциях встречаются слова **параметры** и **аргументы**. Они связаны, но это не одно и то же. @@ -111,3 +115,24 @@ console.log(Math.pow(x + 1, 3)); // => 27 ``` Запоминать это не обязательно, но пригодится при чтении англоязычной литературы. + +## Как узнавать о новых функциях + +У каждой функции есть **сигнатура** — её «описание»: имя, список параметров и тип возвращаемого значения. Именно сигнатура позволяет понять, как пользоваться функцией, не читая её код. Например, документация 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 открыт, и в нём часто можно найти приёмы, о которых не написано в учебниках.