Iterator.prototype.join()

Метод join() экземпляров Iterator аналогичен Array.prototype.join(): он возвращает строку, которая является объединением всех элементов, производимых итератором, разделенных запятыми или указанной разделительной строкой. Если итератор содержит только один элемент, возвращается его строковое представление без использования разделителя.

Синтаксис

join()
join(separator)

Параметры

separator Необязательный

Строка для разделения каждой пары смежных элементов итератора. Если опущено, элементы разделяются запятой (",").

Возвращаемое значение

Строка, объединяющая все возвращенные элементы. Элементы преобразуются в строки. Если элемент является undefined или null, он преобразуется в пустую строку вместо строки "null" или "undefined". Если итератор пуст, возвращается пустая строка.

Описание

См. Array.prototype.join() для получения подробной информации о том, как работает join(). В отличие от большинства других вспомогательных методов итератора, он плохо работает с бесконечными итераторами, так как не является ленивым.

Примеры

Использование join()

function* fibonacci() {
  let current = 1;
  let next = 1;
  while (true) {
    yield current;
    [current, next] = [next, current + next];
  }
}

console.log(fibonacci().take(5).join()); // "1,1,2,3,5"
console.log(fibonacci().take(5).join(" - ")); // "1 - 1 - 2 - 3 - 5"

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

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

См. также

• Polyfill of Iterator.prototype.join in core-js
• es-shims polyfill of Iterator.prototype.join
• Iterator
• Iterator.prototype.reduce()
• Array.prototype.join()