Функции — Переиспользуемые блоки кода
=====================================

* Назад
* Обзор: Building blocks
* Далее

Другая важная концепция в кодировании — **функции** — позволяют хранить фрагмент кода, который выполняет одну задачу внутри определённого блока, а затем вызывать этот код всякий раз, когда вам это нужно, используя одну короткую команду, вместо того, чтобы вводить один и тот же код несколько раз.

В этой статье мы рассмотрим фундаментальные концепции функций, такие как базовый синтаксис, способы вызова и их определения, область действия и параметры.

| Предпосылки: | Начальная компьютерная грамотность, основы HTML и CSS, первые шаги JavaScript. |
| --- | --- |
| Цель: | Понять фундаментальные основы функций языка JavaScript. |

Где можно встретить функции?
----------------------------

В JavaScript, вы везде уведите функции. На самом деле, мы пользовались функциями на протяжении всего курса; только мы не говорили об этом слишком часто. Теперь наступило время, чтобы поговорить о функциях более конкретно и разобрать их синтаксис.

В значительном количестве случаев, когда вы пользуетесь структурой JavaScript, в которой есть пара обычных скобок — `()` — и при этом, это не является структурой типа цикл for, while, или do...while цикл, или if...else конструкция, вы используете функцию.

Встроенные функции браузера
---------------------------

В этом курсе мы использовали функции, встроенные в браузер. Каждый раз, когда мы манипулировали текстовой строкой, например:


```js
var myText = "Я строка";
var newString = myText.replace("строка", "сосиска");
console.log(newString);
// Функция строки replace() принимает строку,
// заменяет одну строку на другую, и возвращает
// новую строку с заменённым содержимым
```


Или каждый раз, когда мы манипулировали массивом:


```js
var myArray = ["Я", "люблю", "шоколадных", "лягушек"];
var madeAString = myArray.join(" ");
console.log(madeAString);
// Функция join() принимает массив, соединяет
// все элементы массива вместе в одну строку,
// и возвращает эту новую строку
```


Или каждый раз, когда мы генерировали случайное число:


```js
var myNumber = Math.random();
// Функция random() генерирует случайное число от 0 до 1,
// и возвращает это число
```


...мы использовали функции!

**Примечание:** вы можете вставить эти строки в консоль вашего браузера, чтобы посмотреть, как работают эти функции.

Фактически, часть кода, который вы вызываете, когда ссылаетесь на встроенную функцию браузера (воображаемое слово для её запуска или выполнения), не может быть написана на JavaScript — многие из этих функций вызывают части фонового кода браузера, который написан в основном на системных языках низкого уровня, таких как C ++, а не на веб-языках, таких как JavaScript.

Имейте в виду, что некоторые встроенные функции браузера не являются частью основного языка JavaScript — некоторые из них являются частью API браузера, которые основываются на языке по умолчанию, чтобы обеспечить ещё большую функциональность (подробнее см. один из предыдущих разделов этого курса). Более подробно рассмотрим использование API браузера в более позднем модуле курса.

Функции или методы
------------------

Одну вещь, которую нам нужно прояснить, прежде чем двигаться дальше - технически, встроенные функции браузера не являются функциями — это **методы**. Это звучит немного страшно и запутанно, но не волнуйтесь — функции и методы слова во многом взаимозаменяемы, по крайней мере для наших целей, на данном этапе вашего обучения.

Разница между методом и функцией лишь в том, что методы - это функции, определённые внутри объектов. Встроенные функции (методы) браузера и переменные (так называемые **свойства**) хранятся внутри структурированных объектов, чтобы сделать код более эффективным и более простым в использовании.

Вам пока не нужно изучать внутреннюю работу структурированных объектов JavaScript - вы можете подождать, пока наш более поздний модуль не научит вас внутренним работам объектов и тому, как создавать свои собственные. На данный момент мы просто хотим устранить любую возможную путаницу метода, в сравнении с функциями - вы, вероятно, встретите оба термина, когда будете смотреть на доступные связанные ресурсы через Интернет.

Пользовательские функции
------------------------

В этом курсе так же использовались **пользовательские функции** — это функции, которые вы определяете в своём коде, а не внутри браузера. Каждый раз, когда вы видели произвольное слово (имя функции) с круглыми скобками прямо после него, вы использовали пользовательскую функцию. В нашем примере random-canvas-circles.html (подробнее см. исходный код) из нашей статьи о циклах мы включили пользовательскую функцию `draw()`, которая выглядит так:


```js
function draw() {
  ctx.clearRect(0, 0, WIDTH, HEIGHT);
  for (var i = 0; i < 100; i++) {
    ctx.beginPath();
    ctx.fillStyle = "rgba(255,0,0,0.5)";
    ctx.arc(random(WIDTH), random(HEIGHT), random(50), 0, 2 \* Math.PI);
    ctx.fill();
  }
}
```


Эта функция рисует 100 случайных кругов внутри элемента `<canvas>`. Каждый раз, когда мы хотим это сделать, мы можем вызвать эту функцию следующим образом


```js
draw();
```


вместо того, чтобы каждый раз, когда мы хотим повторить этот код, не писать его заново. И функции могут содержать любой код, который вам нравится - вы можете даже вызывать другие функции внутри своих функций. Вышеупомянутая функция, например, вызывает функцию `random()` три раза, которая выглядит следующим образом:


```js
function random(number) {
  return Math.floor(Math.random() \* number);
}
```


Нам понадобилась эта функция, потому что встроенная в браузер функция Math.random() генерирует случайное дробное число от 0 до 1. Но мы хотим случайное целое число от 0 до указанного числа.

Вызов функций
-------------

Скорее всего, вы уже поняли это, но на всякий случай ... чтобы использовать функцию после того, как она была определена, вам нужно запустить или вызвать её. Это делается путём включения имени функции в код где-нибудь, за которым следуют скобки.


```js
function myFunction() {
  alert("привет");
}

myFunction();
// Единовременный вызов функции
```

Безымянные функции
------------------

Вы можете видеть функции, определённые и вызываемые несколькими разными способами. До этого мы создавали функции таким способом:


```js
function myFunction() {
  alert("привет");
}
```


Но вы также можете создавать функции без имени:


```js
function() {
  alert('привет');
}
```


Такая функция называется **безымянная функция** (или анонимная) — она не имеет имени! Она сама по себе ничего не делает. Обычно такие функции используются вместе с обработчиком событий, например, следующее будет вызывать код внутри функции каждый раз, по нажатию соответствующей кнопки:


```js
var myButton = document.querySelector("button");

myButton.onclick = function () {
  alert("привет");
};
```


В приведённом примере требуется, чтобы на странице был элемент `<button>` (кнопка), которую нужно нажать. Вы уже видели такую структуру несколько раз на протяжении всего курса, подробнее о ней вы узнаете из следующей статьи.

Вы также можете присвоить к переменной анонимную функцию, например:


```js
var myGreeting = function () {
  alert("привет");
};
```


Теперь эту функцию можно вызвать, используя:


```js
myGreeting();
```


Фактически такой способ присваивает переменной имя; вы также можете присвоить функцию значением нескольких переменных, например:


```js
var anotherGreeting = function () {
  alert("привет");
};
```


Теперь функцию можно вызвать, используя любую из переменных


```js
myGreeting();
anotherGreeting();
```


Но это может ввести в заблуждение, так что не стоит так делать! При создании функций лучше всего придерживаться следующего вида:


```js
function myGreeting() {
  alert("привет");
}
```


Чаще всего вы будете использовать анонимные функции, чтобы просто запускать код при срабатывания события - например, нажатие кнопки - с помощью обработчика событий. Опять же, это выглядит примерно так:


```js
myButton.onclick = function () {
  alert("привет");
  // При желании, внутри этой функции
  // можно написать много кода.
};
```

Параметры функции
-----------------

Некоторые функции при их вызове требуют указание параметров — это значения, которые должны быть вставлены в круглые скобки функции, необходимые для корректной работы функции.

**Примечание:** Параметры иногда называются аргументами, свойствами или атрибутами.

Например встроенная в браузер функция Math.random() не требует параметров. При вызове, она всегда возвращает случайное число от 0 до 1:


```js
var myNumber = Math.random();
```


Браузерная встроенная функция, работающая со строкой, replace() ожидает два параметра — это подстрока для поиска в основной строке и строка, на которую происходит замена в основной строке:


```js
var myText = "Я строка";
var newString = myText.replace("строка", "сосиска");
```


**Примечание:** Если необходимо указать несколько параметров, их разделяют запятыми.

Следует также отметить, что иногда параметры являются необязательными - вам не нужно их указывать. Если вы этого не сделаете, функция, как правило, примет какое-то поведение по умолчанию. В качестве примера параметр функции массива join() необязателен:


```js
var myArray = ["Я", "люблю", "шоколадных", "лягушек"];
var madeAString = myArray.join(" ");
// Вернёт 'Я люблю шоколадных лягушек'
var madeAString = myArray.join();
// Вернёт 'Я,люблю,шоколадных,лягушек'
```


Если не указан параметр для символа соединения / разграничения, по умолчанию используется запятая.

Область видимости функции и конфликты
-------------------------------------

Давайте немного поговорим о scope (en-US) - очень важная концепция при работе с функциями. Когда вы создаёте функцию, переменные и другие вещи, определённые внутри функции, находятся внутри их отдельной **области (scope)**, что означает, что они заперты в своих отдельных отсеках, недоступных из других функций или из кода вне функций.

Верхний уровень за пределами всех ваших функций называется **глобальной областью (global scope)**. Значения, определённые в глобальном масштабе, доступны извне в коде.

JavaScript настроен таким образом по разным причинам - но главным образом из-за безопасности и организации. Иногда вы не хотите, чтобы переменные были доступны извне в коде - внешние скрипты, которые вы вызывали из других источников, могут начать работать с вашим кодом и вызывать проблемы, потому что они используют одни и те же имена переменных, как и другие части кода , вызывая конфликты. Это может быть сделано злонамеренно или просто случайно.

Например, скажем, у вас есть файл HTML, который вызывается в двух внешних файлах JavaScript, и оба они имеют переменную и определённую функцию, которые используют одно и то же имя:


```html
<!-- Excerpt from my HTML -->
<script src="first.js"></script>
<script src="second.js"></script>
<script>
 greeting();
</script>
```



```js
// first.js
var name = "Chris";
function greeting() {
  alert("Hello " + name + ": welcome to our company.");
}
```



```js
// second.js
var name = "Zaptec";
function greeting() {
  alert("Our company is called " + name + ".");
}
```


Обе функции, которые вы хотите вызвать, называются `greeting()`, но вы можете получить доступ только к функции `greeting()` файла `first.js` (функция файла `second.js` игнорируется). Кроме того, попытка объявить переменную `name` второй раз через `let` в файле `second.js` приведёт к ошибке.

**Примечание:** Этот пример можно увидеть в режиме Live на GitHub (см. также исходный код).

Хранение частей вашего кода, заблокированных функциями, позволяет избежать таких проблем и считается наилучшей практикой.

Это немного похоже на зоопарк. Львы, зебры, тигры и пингвины находятся в своих собственных ограждениях и имеют доступ только к вещам внутри их вольеров - таким же образом, как и в области функций. Если бы они смогли попасть в другие вольеры, возникли проблемы. В лучшем случае разные животные будут чувствовать себя неудобно в незнакомых местах обитания - лев или тигр будут чувствовать себя ужасно внутри водянистой, ледяной области пингвинов. В худшем случае львы и тигры могут попытаться съесть пингвинов!

![](/ru/docs/Learn/JavaScript/Building_blocks/Functions/mdn-mozilla-zoo.png)

Хранитель зоопарка подобен глобальной переменной - он или она имеет ключи для доступа к каждому вольеру, для пополнения запасов пищи, ухода за больными животными и т. д.

### Активное обучение: игра с scope

Давайте посмотрим на реальный пример, демонстрирующий обзор.

1. Сначала создайте локальную копию нашего примера function-scope.html. Это содержит две функции, называемые `a()` и `b()`, и три переменные - `x`, `y` и `z` - две из которых определены внутри функций и одна в глобальной области. Он также содержит третью функцию, называемую `output()`, которая принимает один параметр и выводит его в абзаце на странице.
2. Откройте пример в браузере и в текстовом редакторе.
3. Откройте консоль JavaScript в инструментах разработчика вашего браузера. В консоли JavaScript введите следующую команду:

```js
output(x);
```

вы должны увидеть значение переменной `x` вывод на экране.
4. Теперь попробуйте ввести следующее в консоли

```js
output(y);
output(z);
```

Оба из них должны возвращать ошибку в строке "ReferenceError: y is not defined". Почему это? Из-за функции scope - `y` и `z` блокируются внутри функций `a()` и `b()`, поэтому `output()` не может получить к ним доступ при вызове из глобальной области.
5. Однако как насчёт того, когда он вызван изнутри другой функции? Попробуйте отредактировать функции `a()` и `b()`, чтобы они выглядели следующим образом:

```js
function a() {
  var y = 2;
  output(y);
}

function b() {
  var z = 3;
  output(z);
}
```

Сохраните код и перезагрузите его в своём браузере, затем попробуйте вызвать функции `a()` и `b()` из консоли JavaScript:

```js
a();
b();
```

вы должны увидеть значения y и z, выводимые на странице. Это отлично работает, так как функция `output()` вызывается внутри других функций - в той же области, где переменные, которые она печатает, определяются в каждом случае. `output()` доступен из любого места, поскольку он определён в глобальной области.
6. Теперь попробуйте обновить свой код следующим образом:

```js
function a() {
  var y = 2;
  output(x);
}

function b() {
  var z = 3;
  output(x);
}
```

Сохраните и перезагрузите снова и повторите попытку в консоли JavaScript:
7. 
```js
a();
b();
```

Оба вызова `a()` и `b()` должны выводить значение x - 1. Они работают нормально, потому что, хотя вызовы `output()` не находятся в той же области, где определено `x`, `x` - глобальная переменная, поэтому она доступна внутри всего кода, везде
8. Наконец, попробуйте обновить свой код следующим образом:

```js
function a() {
  var y = 2;
  output(z);
}

function b() {
  var z = 3;
  output(y);
}
```

Сохраните и перезагрузите снова и повторите попытку в консоли JavaScript:

```js
a();
b();
```


На этот раз вызовы `a()` и `b()` возвратят эту раздражающую ошибку "ReferenceError: z is not defined" - это потому, что вызовы `output()` и переменные, которые они пытаются распечатать, не определены внутри одних и тех же областей функций - переменные эффективно невидимы для этих вызовов функций.

**Примечание:** Те же правила определения не применяются к циклу (например, `for() { ... }`) и условным блокам (например, `if() { ... }`) - они выглядят очень похожими, но это не одно и то же! Старайтесь не путать их.

**Примечание:** ReferenceError: "x" is not defined. Ошибка - это одна из наиболее распространённых проблем, с которой вы столкнётесь. Если вы получите эту ошибку, и вы уверены, что определили эту переменную, проверьте, в какой области она находится.

### Функции внутри функций

Имейте в виду, что вы можете вызывать функцию из любого места, даже если она внутри другой функции. Это часто используется как способ поддержания чистоты кода. Если у вас есть большая сложная функция, её легче понять, если разбить её на несколько подфункций:


```js
function myBigFunction() {
  var myValue;

  subFunction1();
  subFunction2();
  subFunction3();
}

function subFunction1() {
  console.log(myValue);
}

function subFunction2() {
  console.log(myValue);
}

function subFunction3() {
  console.log(myValue);
}
```


Просто убедитесь, что значения, используемые внутри функции, находятся в области видимости. В приведённом выше примере выдаётся ошибка `ReferenceError: MyValue is not defined`, поскольку хотя переменная `myValue` определена в той же области, что и вызовы функций, она не определена в определениях функций - фактический код, который запускается при вызове функций. Чтобы это работало, вам нужно передать значение в функцию в качестве параметра, например так:


```js
function myBigFunction() {
  var myValue = 1;

  subFunction1(myValue);
  subFunction2(myValue);
  subFunction3(myValue);
}

function subFunction1(value) {
  console.log(value);
}

function subFunction2(value) {
  console.log(value);
}

function subFunction3(value) {
  console.log(value);
}
```

Заключение
----------

В этой статье были рассмотрены основные понятия, лежащие в основе функций, позволяющие освоить следующий материал, в котором мы получим практические навыки, и научимся создавать собственные функции.

Смотрите также
--------------

* Детальное руководство по функциям — описание некоторых дополнительных функций, не описанных в этой статье.
* Описание функций
* Параметры по умолчанию, Стрелочные функции — продвинутая документация

* Назад
* Обзор: Building blocks
* Далее