function* expression

Ключевое слово function* может использоваться для объявления функции-генератора внутри выражения.

Синтаксис

function* [имя]([параметр1[, параметр2[, ..., параметрN]]]) {
   инструкции
}

Параметры

имя
Имя функции. Может быть опущено, в этом случае функция будет анонимной. Имя локально для тела функции.
параметрN
Имя аргумента, передаваемого в функцию. Фунция может иметь до 255 аргументов.
инструкции
Инструкции, составляющие тело функции.

Описание

Выражение function*  очень похоже на обявление function*, и имеет почти такой же синтаксис. Основная разница между выражением function* и объявлением function* – в имени функции, которое может быть опущено в выражениях function* для создания анонимных функций. Смотрите главу о функциях для получения более подробной информации.

Примеры

В следующем примере определяется безымянная функция-генератор и присваивается переменной x. Функция возвращает квадрат своего аргумента:

var x = function*(y) {
   yield y * y;
};

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

Спецификация Статус Комментарий
ECMAScript 2015 (6th Edition, ECMA-262)
Определение 'function*' в этой спецификации.		 Стандарт Изначальное определение.
ECMAScript Latest Draft (ECMA-262)
Определение 'function*' в этой спецификации.		 Черновик

Совместимость с браузерами

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!
Характеристика Chrome Firefox (Gecko) Internet Explorer Opera Safari
Базовая поддержка (Да) 26.0 (26.0) ? ? ?
yield* (Да) 27.0 (27.0) ? ? ?
Характеристика Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Базовая поддержка ? (Да) 26.0 (26.0) ? ? ?
yield* ? (Да) 27.0 (27.0) ? ? ?

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

Связанные темы
  1. JavaScript
  2. Уроки:
  3. Базовые
    1. Основы JavaScript
    2. JavaScript first steps
    3. JavaScript building blocks
    4. Introducing JavaScript objects
  4. Руководство по JavaScript
    1. Вступление
    2. Грамматика и типы
    3. Порядок выполнения и обработка ошибок
    4. Циклы и итерации
    5. Функции
    6. Выражения и операторы
    7. Числа и даты
    8. Форматирование текста
    9. Регулярные выражения
    10. Упорядоченные наборы данных
    11. Коллекции
    12. Работа с объектами
    13. Подробнее об объектной модели
    14. Using promises
    15. Итераторы и генераторы
    16. Метапрограммирование
    17. JavaScript modules
  5. Средние
    1. Introducing JavaScript objects
    2. Client-side web APIs
    3. Повторное введение в JavaScript
    4. Структуры данных JavaScript
    5. Проверки на равенство и когда их использовать
    6. Замыкания
  6. Продвинутые
    1. Наследование и цепочка прототипов
    2. Строгий режим
    3. Типизированные массивы JavaScript
    4. Управление памятью
    5. Модель совпадения и циклы событий
  7. Справочная информация:
  8. Встроенные объекты
    1. Array
    2. ArrayBuffer
    3. AsyncFunction
    4. Atomics
    5. BigInt
    6. BigInt64Array [Перевести]
    7. BigUint64Array [Перевести]
    8. Boolean
    9. DataView
    10. Date
    11. Error
    12. EvalError
    13. Float32Array
    14. Float64Array
    15. Function
    16. Generator
    17. GeneratorFunction
    18. Infinity
    19. Int16Array
    20. Int32Array
    21. Int8Array
    22. InternalError
    23. Intl
    24. Intl.Collator
    25. Intl.DateTimeFormat
    26. Intl.ListFormat
    27. Intl.Locale [Перевести]
    28. Intl.NumberFormat
    29. Intl.PluralRules [Перевести]
    30. Intl.RelativeTimeFormat [Перевести]
    31. JSON
    32. Map
    33. Math
    34. NaN
    35. Number
    36. Object
    37. Promise
    38. Прокси
    39. RangeError
    40. ReferenceError
    41. Reflect
    42. RegExp
    43. Set
    44. SharedArrayBuffer
    45. String
    46. Symbol
    47. SyntaxError
    48. TypeError
    49. TypedArray
    50. URIError
    51. Uint16Array
    52. Uint32Array
    53. Uint8Array
    54. Uint8ClampedArray
    55. WeakMap
    56. WeakSet
    57. WebAssembly
    58. decodeURI()
    59. decodeURIComponent()
    60. encodeURI()
    61. encodeURIComponent()
    62. escape()
    63. eval()
    64. globalThis [Перевести]
    65. isFinite()
    66. isNaN
    67. null
    68. parseFloat()
    69. parseInt()
    70. undefined
    71. unescape()
    72. uneval()
  9. Выражения и операторы
    1. Арифметические операции
    2. Упрощенный синтаксис создания массивов
    3. Операторы присваивания
    4. Битовые операции
    5. Оператор Запятая
    6. Операторы сравнения
    7. Условный (тернарный) оператор
    8. Деструктурирующее присваивание
    9. Expression closures
    10. Упрощенный синтаксис создания функций-генераторов
    11. Оператор группировки
    12. Функция наследования генератора
    13. Логические операторы
    14. Инициализация объектов
    15. Приоритет операторов
    16. Конвейерный оператор
    17. Property accessors
    18. Spread syntax
    19. async function expression
    20. await
    21. class expression
    22. delete
    23. Функциональное выражение
    24. function* expression
    25. in operator
    26. instanceof
    27. Оператор new
    28. new.target
    29. super
    30. this
    31. typeof
    32. void operator
    33. yield
    34. yield*
  10. Инструкции и объявления
    1. Legacy generator function [Перевести]
    2. async function
    3. Блок
    4. break
    5. class
    6. const
    7. continue
    8. debugger
    9. default
    10. do...while
    11. Пустое выражение
    12. export
    13. for
    14. for await...of [Перевести]
    15. for each...in
    16. for...in
    17. for...of
    18. function
    19. function*
    20. if...else
    21. import
    22. import.meta [Перевести]
    23. label
    24. let
    25. return
    26. switch
    27. throw
    28. try...catch
    29. var
    30. while
    31. with
  11. Функции
    1. Стрелочные функции
    2. Параметры по умолчанию
    3. Определение методов
    4. Оставшиеся параметры (rest parameters)
    5. Объект arguments
    6. getter
    7. setter
  12. Классы
    1. constructor
    2. extends
    3. static
  13. Ошибки
    1. Error: Permission denied to access property "x"
    2. InternalError: too much recursion
    3. RangeError: argument is not a valid code point
    4. RangeError: invalid array length
    5. RangeError: invalid date
    6. RangeError: precision is out of range
    7. RangeError: radix must be an integer
    8. RangeError: repeat count must be less than infinity
    9. RangeError: repeat count must be non-negative
    10. ReferenceError: "x" is not defined
    11. ReferenceError: assignment to undeclared variable "x"
    12. ReferenceError: can't access lexical declaration`X' before initialization
    13. Ошибка Ссылки: устаревший вызывающий объект или использование аргументов
    14. ReferenceError: invalid assignment left-hand side
    15. ReferenceError: reference to undefined property "x"
    16. SyntaxError: "0"-prefixed octal literals and octal escape seq. are deprecated
    17. SyntaxError: "use strict" not allowed in function with non-simple parameters
    18. SyntaxError: "x" is a reserved identifier
    19. SyntaxError: JSON.parse: bad parsing
    20. SyntaxError: Malformed formal parameter
    21. SyntaxError: Unexpected token
    22. SyntaxError: Using //@ to indicate sourceURL pragmas is deprecated. Use //# instead
    23. SyntaxError: a declaration in the head of a for-of loop can't have an initializer
    24. SyntaxError: applying the 'delete' operator to an unqualified name is deprecated (SyntaxError: применение оператора 'delete' к неполному имени не рекомендуется)
    25. SyntaxError: for-in loop head declarations may not have initializers(SyntaxError: объявления for-in loop head могут не иметь инициализаторов)
    26. SyntaxError: function statement requires a name(функция оператор требует имя)
    27. SyntaxError: identifier starts immediately after numeric literal(идентификатор начинается сразу после числового литерала)
    28. SyntaxError: illegal character
    29. SyntaxError: invalid regular expression flag "x"
    30. Синтаксическая ошибка: пропущенный символ ")" после списка аргументов
    31. SyntaxError: missing ) after condition
    32. SyntaxError: missing : after property id
    33. SyntaxError: missing ; before statement
    34. SyntaxError: missing = in const declaration
    35. SyntaxError: missing ] after element list
    36. SyntaxError: missing formal parameter( отсутствует формальный параметр)
    37. SyntaxError: missing name after . operator(отсутствует имя после. оператора)
    38. SyntaxError: missing variable name
    39. SyntaxError: missing } after function body
    40. SyntaxError: missing } after property list
    41. SyntaxError: redeclaration of formal parameter "x"
    42. SyntaxError: return not in function
    43. SyntaxError: test for equality (==) mistyped as assignment (=)?(тест на равенство (==) опечатка как присваивание (=)?)
    44. SyntaxError: unterminated string literal(незавершенный строковый литерал)
    45. TypeError: "x" has no properties
    46. TypeError: "x" is (not) "y"
    47. TypeError: "x" is not a constructor
    48. TypeError: "x" is not a function
    49. TypeError: "x" is not a non-null object(Тип ошибки: "x" не является ненулевым объектом)
    50. TypeError: "x" is read-only(Ошибка Типа: "x" только для чтения)
    51. TypeError: 'x' is not iterable (Тип ошибки 'x' не является итерационным)
    52. TypeError: More arguments needed
    53. TypeError: Reduce of empty array with no initial value(Тип ошибки: уменьшение пустого массива без начального значения)
    54. TypeError: can't access dead object (Тип ошибки:не удается получить доступ к мертвому объекту)
    55. TypeError: can't access property "x" of "y"(Тип ошибки: не удается получить доступ к свойству "x" из "y")
    56. TypeError: can't assign to property "x" on "y": not an object [Перевести]
    57. TypeError: can't define property "x": "obj" is not extensible(Тип ошибки:не удается определить свойство "x": "obj" не является расширяемым)
    58. TypeError: can't delete non-configurable array element(Тип ошибки:не удается удалить настраиваемый элемент массива)
    59. TypeError: can't redefine non-configurable property "x"(Тип ошибки: не удается переопределить настраиваемое свойство "x")
    60. TypeError: cannot use 'in' operator to search for 'x' in 'y'(не удается использовать 'in' оператор поиска для 'x' в 'y')
    61. TypeError: cyclic object value(TypeError: циклическое значение объекта)
    62. TypeError: invalid 'instanceof' operand 'x'(Тип ошибки: неверный 'экземпляром' операнд 'х')
    63. TypeError: invalid Array.prototype.sort argument (TypeError: недопустимый Array.prototype.sort argument)
    64. TypeError: invalid arguments(Тип ошибки: неправильный аргумент)
    65. TypeError: invalid assignment to const "x"(недопустимое назначение const "x")
    66. TypeError: property "x" is non-configurable and can't be deleted(свойство "x" не настраивается и не может быть удалено)
    67. TypeError: setting getter-only property "x"(установка свойства только для геттера "x")
    68. TypeError: переменная "x" переопределяет аргумент
    69. URIError: malformed URI sequence
    70. Warning: -file- is being assigned a //# sourceMappingURL, but already has one(Внимание: -file- является в сущности назначенным //# sourceMappingURL, но уже имеет один)
    71. Внимание: 08/09 не является восьмеричной постоянной по ECMA-262
    72. Warning: Date.prototype.toLocaleFormat (Является устаревшим)
    73. Предупреждение: циклы JavaScript 1.6 for-each-in устарели
    74. Warning: String.x is deprecated; use String.prototype.x instead
    75. Предупреждение: затворы выражения являются устаревшими
    76. Warning: unreachable code after return statement
    77. X.prototype.y called on incompatible type
  14. Ещё
    1. Обзор технологий JavaScript
    2. Лексическая грамматика
    3. Структуры данных JavaScript
    4. Перечисляемость и принадлежность свойств
    5. Протоколы перебора
    6. Строгий режим
    7. Переход в строгий режим
    8. Шаблонные строки
    9. Устаревшие возможности
  15. Новое в JavaScript
    1. Поддержка ECMAScript 6 в Mozilla
    2. Поддержка ECMAScript 5 в Mozilla
    3. Firefox JavaScript changelog
    4. New in JavaScript 1.1 [Перевести]
    5. New in JavaScript 1.2 [Перевести]
    6. New in JavaScript 1.3 [Перевести]
    7. New in JavaScript 1.4 [Перевести]
    8. Новое в JavaScript 1.5
    9. Новое в JavaScript 1.6
    10. Новое в JavaScript 1.7
    11. New in JavaScript 1.8
    12. Новое в JavaScript 1.8.1
    13. Новое в JavaScript 1.8.5
  16. Документация:
  17. Полезные списки
    1. Индекс всех страниц
    2. Индекс методов
    3. Индекс свойств
    4. Страницы, помеченные «JavaScript»
  18. Внести свой вклад
    1. Статус документации по JavaScript
    2. Проект MDN