Функции и классы JavaScript

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

Правила this и наследование через прототипы объясняет раздел «Как работает JavaScript». Операторы new и super описаны в разделе «Операторы и выражения».

Группы статей

Функции

Виды функций

Способы создать функцию и чем они отличаются.

Виды функций
Конструкция Назначение
Объявление function Создаёт именованную функцию, доступную до строки объявления в её области видимости.
Функциональное выражение Создаёт функцию как значение внутри выражения.
Стрелочная функция Краткая запись функции без своего this и arguments.
function* Функция, которая выдаёт значения по одному через yield.
async function Функция, которая возвращает Promise и может ждать через await.
async function* Генератор, значения которого приходят асинхронно. Перебирается for await...of.

Объявления, выражения и результат вызова

Обычная, асинхронная, генераторная и асинхронная генераторная функция могут быть объявлениями, выражениями или методами. Например, const sequence = function* () { yield 1; } сохраняет генераторную функцию в переменную. Стрелка всегда является выражением.

Результат вызова разных форм функции
Форма Результат и существенные ограничения
function При обычном вызове возвращает значение return или undefined. Имеет собственные this и arguments. Обычная функция поддерживает создание экземпляра через new.
=> Возвращает значение выражения либо явного return. Берёт this и arguments из внешнего контекста, не вызывается с new.
async function, async () => Возвращают новый Promise. await приостанавливает только текущую функцию. У асинхронной стрелки сохраняются обычные правила стрелок.
function* Возвращает синхронный генератор. Тело начинает работу по запросу next(), результаты имеют вид { value, done }.
async function* Возвращает асинхронный генератор. Его запросы возвращают Promise с результатом { value, done }, а выданный Promise ожидается до передачи значения потребителю.

Асинхронные и генераторные функции, а также краткие методы не являются конструкторами. Генераторной стрелки нет. Полезно различать функцию, объект генератора и Promise: они вызываются и перебираются разными способами.

Параметры

Как функция получает аргументы.

Параметры
Конструкция Назначение
Параметры по умолчанию Значение параметра, если аргумент не передан или равен undefined.
Rest-параметры Собирает оставшиеся аргументы в массив.
arguments Локальный массивоподобный объект со всеми аргументами вызова нестрелочной функции. Сам объект не устарел.

Функции как объекты и arguments

Этот раздел посвящён синтаксису функций и классов. Свойства name, length, prototype и методы call(), apply(), bind(), toString() описаны в отдельном справочнике Function. Не путайте свойство функции length с числом аргументов конкретного вызова.

У локального объекта arguments есть индексные значения, length с числом переданных аргументов и [Symbol.iterator](), возвращающий новый итератор этих значений. Устаревшее callee обращается к выполняющейся функции и запрещено для строгих функций и непростых параметров. Подробности и ограничения — в таблице свойств arguments ниже.

Члены объекта arguments

Подробные правила собственных свойств локального объекта аргументов:

Члены arguments
Член Назначение
arguments.length Число переданных аргументов и отличие от длины функции
arguments[Symbol.iterator]() Независимые итераторы и чтение значений во время обхода
arguments.callee Устаревшая ссылка на текущую функцию, ограничения доступа и замена в рекурсии

Методы

Функции-свойства объектов и свойства-аксессоры.

Методы
Конструкция Назначение
Определение методов Краткая запись функции-свойства в объекте и классе.
get Свойство, значение которого вычисляет функция при чтении.
set Свойство, запись в которое вызывает функцию.

Классы

Объявление класса и его элементы. Выражение класса const Item = class {} рассмотрено в статье class.

Классы
Конструкция Назначение
class Объявляет класс — шаблон для создания объектов.
constructor Метод класса, который настраивает новый экземпляр.
Поля класса Свойства, которые получает каждый экземпляр при создании.
static Методы и поля самого класса, а не его экземпляров.
Приватные элементы Поля и методы #имя, доступные только внутри класса.
extends Создаёт класс-наследник конструктора или класс с extends null.
Блоки статической инициализации Код, который выполняется один раз при создании класса.

Сочетания элементов класса

Поля, методы, геттеры и сеттеры бывают публичными или приватными, принадлежат экземпляру или самому классу. Ниже показаны формы элементов, а x и m — выбранные имена. Приватные имена доступны из кода объявившего их класса.

Публичные и приватные элементы экземпляра и класса
Вид Экземпляр Сам класс
Поле x = 1, #x = 1 static x = 1, static #x = 1
Метод m() {}, #m() {} static m() {}, static #m() {}
Геттер get x() {}, get #x() {} static get x() {}, static get #x() {}
Сеттер set x(value) {}, set #x(value) {} static set x(value) {}, static set #x(value) {}

Это отдельные варианты синтаксиса, их нельзя все объявить с одинаковыми приватными именами в одном классе. Кроме этих форм есть специальный constructor и блоки static {}. Публичные методы и аксессоры экземпляра находятся на прототипе, поля — на самом экземпляре. Статические элементы определяются на конструкторе.

Спецификация

ECMAScript: Functions and Classes, Arguments Exotic Objects.