` (например, чтобы сделать элемент DOM видимым после того, как у него есть содержимое). Вы, вероятно, не захотите показывать элемент DOM до того, как у него будет содержимое, поэтому координация должна обеспечивать правильное взаимодействие с упорядочением.\n\nНекоторые сценарии конкуренции *всегда ломаются* (а не просто *иногда*) без скоординированного взаимодействия. \n\nРассмотрим:\n\n```js\nvar a, b;\n\nfunction foo(x) {\n\ta = x * 2;\n\tbaz();\n}\n\nfunction bar(y) {\n\tb = y * 2;\n\tbaz();\n}\n\nfunction baz() {\n\tconsole.log(a + b);\n}\n\najax( \"http://some.url.1\", foo );\najax( \"http://some.url.2\", bar );\n```\n\nВ этом примере, независимо от того, срабатывает ли сначала `foo()` или `bar()`, `baz()` всегда будет запускаться слишком рано (либо `a`, либо `b` все еще будут `undefined`), но второй вызов `baz()` будет работать, так как будут доступны и `a`, и `b`.\n\nСуществуют разные способы справиться с таким состоянием. Вот один простой способ:\n\n```js\nvar a, b;\n\nfunction foo(x) {\n\ta = x * 2;\n\tif (a && b) {\n\t\tbaz();\n\t}\n}\n\nfunction bar(y) {\n\tb = y * 2;\n\tif (a && b) {\n\t\tbaz();\n\t}\n}\n\nfunction baz() {\n\tconsole.log( a + b );\n}\n\najax( \"http://some.url.1\", foo );\najax( \"http://some.url.2\", bar );\n```\n\nУсловие `if (a && b)` вокруг вызова `baz()` традиционно называется \"воротами\", потому что мы не уверены, какой порядок `a` и `b` прибудет, но мы ждем оба из них, чтобы попасть туда, прежде чем мы приступим к открытию ворот (вызов `baz()`).\n\nЕще одно условие конкурентного взаимодействия, с которым вы можете столкнуться, иногда называют «гонкой», но правильнее называть его «защелкой». Характеризуется поведением «побеждает только первый». Здесь приемлем недетерминизм, поскольку вы явно говорите, что в «гонке» до финиша может быть только один победитель.\n\nРассмотрим этот сломанный код:\n\n```js\nvar a;\n\nfunction foo(x) {\n\ta = x * 2;\n\tbaz();\n}\n\nfunction bar(x) {\n\ta = x / 2;\n\tbaz();\n}\n\nfunction baz() {\n\tconsole.log( a );\n}\n\najax( \"http://some.url.1\", foo );\najax( \"http://some.url.2\", bar );\n```\n\nКакой бы из них (`foo()` или `bar()`) не срабатывал последним, он не только перезапишет назначенное значение `a` из другого, но также будет дублировать вызов `baz()` (вероятно, нежелательный).\n\nИтак, мы можем согласовать взаимодействие с простой защелкой, чтобы пропускать только первую:\n\n```js\nvar a;\n\nfunction foo(x) {\n\tif (a == undefined) {\n\t\ta = x * 2;\n\t\tbaz();\n\t}\n}\n\nfunction bar(x) {\n\tif (a == undefined) {\n\t\ta = x / 2;\n\t\tbaz();\n\t}\n}\n\nfunction baz() {\n\tconsole.log( a );\n}\n\najax( \"http://some.url.1\", foo );\najax( \"http://some.url.2\", bar );\n```\n\nУсловие `if (a == undefined)` допускает только первый из `foo()` или `bar()`, а второй (и любые последующие) вызовы будут просто проигнорированы. Нет ничего хорошего в том, чтобы занять второе место!\n\n**Примечание.** Во всех этих сценариях мы использовали глобальные переменные для упрощения иллюстрации, но в наших рассуждениях здесь нет ничего, что требовало бы этого. Пока рассматриваемые функции могут получить доступ к переменным (через область видимости), они будут работать так, как задумано. Использование переменных с лексической областью видимости (см. название этой серии книг *Scope & Closures*) и фактически глобальных переменных, как в этих примерах, является очевидным недостатком этих форм координации в условиях конкуренции. В следующих нескольких главах мы увидим другие способы координации, которые в этом отношении намного чище.\n\n### Кооперация\n\nДругое выражение координации параллелизма называется «кооперативной конкуренцией» (cooperative concurrency). Здесь основное внимание уделяется не столько взаимодействию через совместное использование значений в областях видимости (хотя это, очевидно, все еще разрешено!). Цель состоит в том, чтобы взять длительный «процесс» и разбить его на шаги или пакеты, чтобы другие конкурирующие «процессы» имели возможность вставить свои операции в очереди цикла событий.\n\nНапример, рассмотрим обработчик ответа Ajax, которому необходимо просмотреть длинный список результатов для преобразования значений. Мы будем использовать `Array#map(..)`, чтобы сделать код короче:\n\n```js\nvar res = [];\n\n// `response(..)` получает массив результатов от Ajax-вызова\nfunction response(data) {\n // добавляем в существующий массив `res`\n\tres = res.concat(\n // создаем новый преобразованный массив со всеми удвоенными значениями `data`\n\t\tdata.map( function(val){\n\t\t\treturn val * 2;\n\t\t} )\n\t);\n}\n\najax( \"http://some.url.1\", response );\najax( \"http://some.url.2\", response );\n```\n\nЕсли `\"http://some.url.1\"` сначала получит свои результаты, весь список будет сразу отображен в `res`. Если это несколько тысяч или меньше записей, это, как правило, не имеет большого значения. Но если это, скажем, 10 миллионов записей, это может занять некоторое время (несколько секунд на мощном ноутбуке, намного дольше на мобильном устройстве и т.д.).\n\nВо время выполнения такого «процесса» на странице не может происходить ничего другого, включая другие вызовы `response(..)`, обновления пользовательского интерфейса, даже пользовательские события, такие как прокрутка, ввод текста, нажатие кнопки и тому подобное. Это довольно болезненно.\n\nТаким образом, чтобы сделать более кооперативно конкурентную систему, более дружелюбную и не перегружающую очередь цикла событий, вы можете обрабатывать эти результаты асинхронными пакетами, после того как каждый из них «уступает» обратно в цикл событий, чтобы позволить произойти другим ожидающим событиям.\n\nВот очень простой подход:\n\n```js\nvar res = [];\n\n// `response(..)` получает массив результатов от Ajax-вызова\nfunction response(data) {\n // давайте просто сделаем 1000 за раз\n\tvar chunk = data.splice( 0, 1000 );\n\n // добавляем в существующий массив `res`\n\tres = res.concat(\n\t\t// создаем новый преобразованный массив со всеми удвоенными значениями `chunk`\n\t\tchunk.map( function(val){\n\t\t\treturn val * 2;\n\t\t} )\n\t);\n\n // осталось что-нибудь обработать?\n\tif (data.length > 0) {\n\t\t// асинхронно планируем следующую партию\n\t\tsetTimeout( function(){\n\t\t\tresponse( data );\n\t\t}, 0 );\n\t}\n}\n\najax( \"http://some.url.1\", response );\najax( \"http://some.url.2\", response );\n```\n\nМы обрабатываем набор данных блоками максимального размера по 1000 элементов. Поступая таким образом, мы обеспечиваем кратковременный «процесс», даже если это означает гораздо больше последующих «процессов», поскольку чередование с очередью цикла событий даст нам гораздо более отзывчивый (производительный) сайт/приложение.\n\nКонечно, мы не координируем порядок взаимодействия любого из этих «процессов», поэтому порядок результатов в `res` не будет предсказуемым. Если бы требовался порядок, вам нужно было бы использовать методы взаимодействия, подобные тем, которые мы обсуждали ранее, или те, которые мы рассмотрим в следующих главах этой книги.\n\nМы используем `setTimeout(..0)` (хак) для асинхронного планирования, что в основном просто означает «вставить эту функцию в конец текущей очереди цикла событий».\n\n**Примечание:** `setTimeout(..0)` технически не вставляет элемент непосредственно в очередь цикла событий. Таймер вставит событие при следующей возможности. Например, два последовательных вызова `setTimeout(..0)` не будут строго гарантированы для обработки в порядке вызова, поэтому *возможно* увидеть различные условия, такие как дрейф таймера, когда порядок таких событий не предсказуем. В Node.js аналогичный подход — `process.nextTick(..)`. Несмотря на то, насколько удобным (и, как правило, более производительным) это было бы, не существует единого прямого способа (по крайней мере, пока) во всех средах для обеспечения асинхронного упорядочения событий. Мы рассмотрим эту тему более подробно в следующем разделе.\n\n## Задачи\n\nНачиная с ES6, появилась новая концепция над очередью цикла событий, которая называется \"Очередь задач\". Скорее всего, вам придется столкнуться с асинхронным поведением промисов (см. главу 3).\n\nК сожалению, на данный момент это механизм без открытого API, поэтому демонстрация его немного сложнее. Так что нам нужно просто описать его концептуально, чтобы, когда мы будем обсуждать асинхронное поведение с промисами в главе 3, вы поняли, как эти действия планируются и обрабатываются.\n\nИтак, лучший способ думать об этом, который я нашел, состоит в том, что «Очередь задач» — это очередь, свисающая с конца каждого такта в очереди цикла событий. Некоторые подразумеваемые асинхронные действия, которые могут произойти во время такта цикла событий, не приведут к добавлению нового события в очередь цикла событий, а вместо этого добавят элемент (также известный как задача) в конец очереди задач текущего такта.\n\nЭто все равно, что сказать: «О, вот еще одна вещь, которую мне нужно сделать *позже*, но убедитесь, что это произойдет прямо сейчас, прежде чем что-либо еще может произойти».\n\nИли, если использовать метафору: очередь цикла событий подобна аттракциону в парке развлечений, где, как только вы закончите кататься, вам нужно вернуться в конец очереди, чтобы прокатиться снова. Но очередь задач похожа на то, как если бы вы закончили поездку, но затем встали в очередь и сразу же вернулись.\n\nЗадача также может привести к добавлению дополнительных задач в конец одной и той же очереди. Таким образом, теоретически возможно, что «цикл» задач (задача, которая продолжает добавлять другую задачу и т.д.) может вращаться бесконечно, лишая программу возможности перейти к следующему такту цикла событий. Концептуально это было бы почти так же, как простое выражение длительного или бесконечного цикла (например, `while (true) ..`) в вашем коде.\n\nЗадачи похожи на дух хака `setTimeout(..0)`, но реализованы таким образом, чтобы иметь гораздо более четко определенный и гарантированный порядок: **позже, но как можно скорее**.\n\nДавайте представим API для планирования задач (напрямую, без хаков) и назовем его `schedule(..)`.\n\n```js\nconsole.log( \"A\" );\n\nsetTimeout( function(){\n\tconsole.log( \"B\" );\n}, 0 );\n\n// теоретический \"API задачи\"\nschedule( function(){\n\tconsole.log( \"C\" );\n\n\tschedule( function(){\n\t\tconsole.log( \"D\" );\n\t} );\n} );\n```\n\nВы можете ожидать, что это напечатает `A B C D`, но вместо этого будет напечатано `A C D B`, потому что задачи происходят в конце текущего такта цикла событий, и таймер срабатывает, чтобы запланировать *следующий* такт цикла событий (если доступно!).\n\nВ главе 3 мы увидим, что асинхронное поведение промисов основано на задачах, поэтому важно четко понимать, как это связано с поведением цикла обработки событий.\n\n## Порядок операторов\n\nПорядок, в котором мы выражаем операторы в нашем коде, не обязательно совпадает с порядком, в котором JS-движок будет их выполнять. Это может показаться довольно странным утверждением, поэтому мы кратко рассмотрим его.\n\nНо прежде чем мы это сделаем, мы должны кое-что предельно ясно уяснить: правила/грамматика языка (см. название этой серии книг *Типы и грамматика*) диктуют очень предсказуемое и надежное поведение для упорядочения операторов с точки зрения программы. Итак, то, что мы собираемся обсудить, — это **не то, что вы когда-либо сможете наблюдать** в своей JS-программе.\n\n**Предупреждение:** Если вы когда-либо сможете *наблюдать* переупорядочивание операторов компилятора, как мы собираемся проиллюстрировать, это будет явным нарушением спецификации, и это, несомненно, будет связано с ошибкой в движке JS. в вопросе - тот, который должен быть немедленно сообщен и исправлен! Но гораздо чаще вы *подозреваете* что-то сумасшедшее происходит в движке JS, когда на самом деле это просто ошибка (вероятно, \"состояние гонки\"!) в вашем собственном коде - так что сначала смотрите туда, и снова и снова . Отладчик JS, использующий точки останова и последовательно выполняющий код, станет вашим самым мощным инструментом для обнаружения таких ошибок в *вашем коде*.\n\nРассмотреть возможность:\n\n```js\nvar a, b;\n\na = 10;\nb = 30;\n\na = a + 1;\nb = b + 1;\n\nconsole.log( a + b ); // 42\n```\n\nЭтот код не имеет выраженной асинхронности (за исключением редкого «консольного» асинхронного ввода-вывода, который обсуждался ранее!), поэтому наиболее вероятным предположением будет то, что он будет обрабатывать строку за строкой сверху вниз.\n\nНо *возможно*, что движок JS после компиляции этого кода (да, JS скомпилирован — см. название *Scope & Closures* этой серии книг!) может найти возможности для более быстрого запуска вашего кода, перестраивая (безопасно) порядок этих выражений. По сути, пока вы не можете наблюдать за изменением порядка, все в порядке.\n\nНапример, движок может решить, что на самом деле быстрее выполнить такой код:\n\n```js\nvar a, b;\n\na = 10;\na++;\n\nb = 30;\nb++;\n\nconsole.log( a + b ); // 42\n```\n\nИли это:\n\n```js\nvar a, b;\n\na = 11;\nb = 31;\n\nconsole.log( a + b ); // 42\n```\n\nИли даже:\n\n```js\n// так как `a` и `b` больше не используются, мы можем\n// встроить их и даже не нуждаться в них!\nconsole.log( 42 ); // 42\n```\n\nВо всех этих случаях движок JS выполняет безопасную оптимизацию во время компиляции, так как конечный *наблюдаемый* результат будет одним и тем же.\n\nНо вот сценарий, в котором эти конкретные оптимизации были бы небезопасными и, следовательно, не могли бы быть разрешены (конечно, нельзя сказать, что они вообще не оптимизированы):\n\n```js\nvar a, b;\n\na = 10;\nb = 30;\n\n// нам нужны `a` и `b` в их предварительно увеличенном состоянии!\nconsole.log( a * b ); // 300\n\na = a + 1;\nb = b + 1;\n\nconsole.log( a + b ); // 42\n```\n\nДругие примеры, когда переупорядочивание компилятора может создать наблюдаемые побочные эффекты (и, следовательно, должно быть запрещены), включают в себя такие вещи, как любой вызов функции с побочными эффектами (даже и особенно функции-получатели) или прокси-объекты ES6 (см. заголовок *ES6 & Beyond* статьи эту серию книг).\n\nРассмотрим возможность:\n\n```js\nfunction foo() {\n\tconsole.log( b );\n\treturn 1;\n}\n\nvar a, b, c;\n\n// Синтаксис литерала геттера ES5.1\nc = {\n\tget bar() {\n\t\tconsole.log( a );\n\t\treturn 1;\n\t}\n};\n\na = 10;\nb = 30;\n\na += foo();\t\t\t\t// 11\nb += c.bar;\t\t\t\t// 31\n\nconsole.log( a + b );\t// 42\n```\n\nЕсли бы не операторы `console.log(..)` в этом фрагменте (просто используемые как удобная форма наблюдаемого побочного эффекта для иллюстрации), движок JS, вероятно, мог бы свободно, если бы захотел (кто знает, захочет ли!?), изменить порядок кода:\n\n```js\n// ...\n\na = 10 + foo();\nb = 30 + c.bar;\n\n// ...\n```\n\nВ то время как семантика JS, к счастью, защищает нас от *наблюдаемых* кошмаров, которым может угрожать переупорядочивание операторов компилятора, по-прежнему важно понимать, насколько незначительна связь между способом создания исходного кода (сверху вниз) и как он работает после компиляции.\n\nПереупорядочивание операторов компилятора — это почти микрометафора конкурентности и взаимодействия. В целом такая осведомленность может помочь вам лучше понять проблемы потока асинхронного кода JS.\n\n## Обзор\n\nПрограмма JavaScript (практически) всегда разбивается на две или более частей, где первая часть выполняется *сейчас*, а следующая часть выполняется *позже*, в ответ на событие. Несмотря на то, что программа выполняется по частям, все они имеют одинаковый доступ к области действия и состоянию программы, поэтому каждое изменение состояния выполняется поверх предыдущего состояния.\n\nВсякий раз, когда есть события для запуска, *цикл событий* выполняется до тех пор, пока очередь не станет пустой. Каждая итерация цикла событий — это \"такт\". Взаимодействие с пользователем, ввод-вывод и таймеры помещают события в очередь событий.\n\nВ любой момент времени из очереди может быть обработано только одно событие. Во время выполнения события оно может прямо или косвенно вызывать одно или несколько последующих событий.\n\nКонкурентность — это когда две или более цепочек событий чередуются во времени, так что с точки зрения высокого уровня кажется, что они выполняются *одновременно* (даже если в любой момент обрабатывается только одно событие).\n\nЧасто бывает необходимо выполнить какую-то форму координации взаимодействия между этими конкурирующими «процессами» (в отличие от процессов операционной системы), например, чтобы обеспечить упорядоченность или предотвратить «состояние гонки». Эти «процессы» также могут *взаимодействовать*, разбивая себя на более мелкие фрагменты и допуская чередование других «процессов».\n"
},
{
"path": "async & performance/ch2.md",
"content": "# Вы не знаете JS: Асинхронность и Выполнение\n# Глава 2: Колбеки\n\nВ главе 1 мы рассмотрели терминологию и концепции асинхронного программирования в JavaScript. Наше внимание сосредоточено на понимании однопоточной (по одному за раз) очереди цикла событий, которая управляет всеми «событиями» (вызовами асинхронных функций). Мы также исследовали различные способы, которыми шаблоны конкурентности объясняют отношения (если они есть!) между *одновременно* запущенными цепочками событий или «процессами» (задачами, вызовами функций и т.д.).\n\nВо всех наших примерах в главе 1 функция использовалась как отдельная, неделимая единица операций, при этом внутри функции операторы выполняются в предсказуемом порядке (выше уровня компилятора!), но на уровне упорядочения функций события (также известные как асинхронные вызовы функций) могут происходить в различных порядках.\n\nВо всех этих случаях функция действует как «обратный вызов», потому что она служит целью цикла обработки событий для «обратного вызова» программы всякий раз, когда обрабатывается этот элемент в очереди.\n\nКак вы, несомненно, заметили, обратные вызовы являются наиболее распространенным способом выражения и управления асинхронностью в JS-программах. Действительно, обратный вызов является наиболее фундаментальным асинхронным шаблоном в языке.\n\nБесчисленные JS-программы, даже очень изощренные и сложные, были написаны только на основе коллбеков (конечно, с использованием шаблонов параллелизма, которые мы рассмотрели в главе 1). Функция обратного вызова — это асинхронная рабочая лошадка для JavaScript, и она достойно выполняет свою работу.\n\nЗа исключением... обратные вызовы не лишены недостатков. Многие разработчики воодушевлены *обещанием* (каламбур!) улучшенных асинхронных шаблонов. Но невозможно эффективно использовать любую абстракцию, если вы не понимаете, что она абстрагирует и почему.\n\nВ этой главе мы подробно рассмотрим пару из них, чтобы понять, почему необходимы и желательны более сложные асинхронные шаблоны (рассматриваемые в последующих главах этой книги).\n\n## Продолжения\n\nДавайте вернемся к примеру с асинхронным обратным вызовом, с которого мы начали в главе 1, но позвольте мне немного изменить его, чтобы проиллюстрировать один момент:\n\n```js\n// A\najax( \"..\", function(..){\n\t// C\n} );\n// B\n```\n\n`// A` и `// B` представляют первую половину программы (она же *сейчас*), а `//C` отмечает вторую половину программы (она же *позже*). Первая половина выполняется сразу, а потом идет \"пауза\" неопределенной длины. В какой-то момент в будущем, если вызов Ajax завершится, программа продолжит с того места, где остановилась, и *продолжит* со второй половиной.\n\nДругими словами, функция обратного вызова оборачивает или инкапсулирует *продолжение* программы.\n\nСделаем код еще проще:\n\n```js\n// A\nsetTimeout( function(){\n\t// C\n}, 1000 );\n// B\n```\n\nОстановитесь на мгновение и спросите себя, как бы вы описали (кому-то другому, менее осведомленному о том, как работает JS) поведение этой программы. Давай, попробуй вслух. Это хорошее упражнение, которое поможет моим следующим пунктам стать более осмысленными.\n\nБольшинство читателей сейчас, вероятно, подумали или сказали что-то вроде: «Выполните A, затем установите тайм-аут на 1000 миллисекунд, затем, как только это сработает, выполните C». Насколько точно было ваше толкование?\n\nВозможно, вы поймали себя на том, что сами отредактировали: «Выполните А, установите тайм-аут на 1000 миллисекунд, затем выполните B, затем, когда истечет тайм-аут, сделайте С». Это более точно, чем первая версия. Вы можете заметить разницу?\n\nНесмотря на то, что вторая версия является более точной, обе версии не могут объяснить этот код таким образом, чтобы наш мозг соответствовал коду, а код — движку JS. Это отключение одновременно тонкое и монументальное, и оно лежит в основе понимания недостатков обратных вызовов как асинхронного выражения и управления.\n\nКак только мы вводим одно продолжение (или несколько десятков, как многие программы!) в виде функции обратного вызова, мы позволяем образоваться расхождению между тем, как работает наш мозг, и тем, как будет работать код. Каждый раз, когда эти двое расходятся (и это далеко не единственное место, где это происходит, как я уверен, вы знаете!), мы сталкиваемся с неизбежным фактом, что наш код становится труднее понимать, анализировать, отлаживать и поддерживать.\n\n## Последовательный мозг\n\nЯ почти уверен, что большинство из вас, читатели, слышали, как кто-то сказал (даже сами заявили): «Я многозадачный». Эффекты от попытки действовать в качестве многозадачного человека варьируются от забавных (например, глупая детская игра «погладь голову-потирай-живот») до обыденных (жуй жвачку на ходу) и откровенно опасных (текстовые сообщения за рулем).\n\nНо многозадачны ли мы? Можем ли мы действительно совершать два сознательных, преднамеренных действия одновременно и думать/рассуждать о них обоих в один и тот же момент? Есть ли у нашего самого высокого уровня функциональности мозга параллельная многопоточность?\n\nОтвет может вас удивить: **вероятно, нет.**\n\nНа самом деле наш мозг просто не так устроен. Мы гораздо больше занимаемся одиночными делами, чем многие из нас (особенно личности типа А!) хотели бы признать. На самом деле мы можем думать только об одном в любой данный момент.\n\nЯ не говорю обо всех наших непроизвольных, подсознательных, автоматических функциях мозга, таких как сердцебиение, дыхание и моргание век. Все это жизненно важные задачи для нашей устойчивой жизни, но мы намеренно не выделяем для них никаких умственных способностей. К счастью, пока мы одержимы проверкой ленты социальных сетей в 15-й раз за три минуты, наш мозг продолжает выполнять все эти важные задачи в фоновом режиме (потоки!)\n\nВместо этого мы говорим о любой задаче, которая находится в центре нашего внимания в данный момент. Для меня это написание текста в этой книге прямо сейчас. Выполняю ли я какую-либо другую функцию мозга более высокого уровня точно в этот же момент? Нет, не совсем. Я отвлекаюсь быстро и легко — несколько десятков раз в этих последних парах абзацев!\n\nКогда мы *имитируем* многозадачность, например, пытаемся что-то напечатать во время разговора с другом или членом семьи по телефону, на самом деле мы, скорее всего, действуем как быстрые переключатели контекста. Другими словами, мы переключаемся между двумя или более задачами в быстрой последовательности, *одновременно* продвигаясь по каждой задаче маленькими, быстрыми порциями. Мы делаем это так быстро, что внешнему миру кажется, будто мы делаем эти вещи *параллельно*.\n\nЗвучит ли это для вас подозрительно как конкурентность с асинхронными событиями (подобная той, что происходит в JS)?! Если нет, вернитесь и прочитайте главу 1 еще раз!\n\nНа самом деле, один из способов упростить (т. е. злоупотребить) невероятно сложный мир неврологии и превратить его в то, что я могу отдалённо надеяться обсудить здесь, заключается в том, что наш мозг работает примерно так же, как очередь цикла событий.\n\nЕсли вы думаете о каждой отдельной букве (или слове), которую я печатаю, как об одном асинхронном событии, только в этом предложении есть несколько десятков возможностей для моего мозга быть прерванным каким-то другим событием, например, от моих органов чувств или даже просто от моего сознания. случайные мысли.\n\nМеня не прерывают и не вовлекают в другой «процесс» при каждой возможности (к счастью, иначе эта книга никогда не была бы написана!). Но достаточно часто случается так, что я чувствую, что мой собственный мозг почти постоянно переключается на разные контексты (также известные как «процессы»). И это очень похоже на то, как, вероятно, чувствовал бы себя движок JS.\n\n### Делать VS Планировать\n\nИтак, наш мозг можно представить как работающий в однопоточной очереди цикла событий подобно движку JS. Это звучит как хорошая аналогия.\n\nНо нам нужно быть более тонкими анализируя это. Существует большая, заметная разница между тем, как мы планируем различные задачи, и тем, как наш мозг на самом деле выполняет эти задачи.\n\nОпять же, вернемся к написанию этого текста как моей метафоры. Мой грубый ментальный план состоит в том, чтобы продолжать писать и писать, последовательно проходя через набор пунктов, которые я упорядочил в своих мыслях. Я не планирую никаких перерывов или нелинейной активности в этом письме. Но тем не менее мой мозг все время переключается.\n\nНесмотря на то, что на операционном уровне наш мозг работает асинхронно, кажется, что мы планируем задачи последовательно и синхронно. «Мне нужно сходить в магазин, потом купить молока, а потом сдать вещи из химчистки».\n\nВы заметите, что это мышление более высокого уровня (планирование) не кажется очень асинхронным в своей формулировке. На самом деле, мы редко намеренно думаем исключительно с точки зрения событий. Вместо этого мы планируем все тщательно, последовательно (А затем Б затем С), и мы допускаем до некоторой степени своего рода временную блокировку, которая заставляет Б ждать А, а С ждать Б.\n\nКогда разработчик пишет код, он планирует ряд действий, которые должны произойти. Если он хороший разработчик, то он **тщательно планирует** это. «Мне нужно установить `z` в значение `x`, а затем `x` в значение `y`» и так далее.\n\nКогда мы пишем синхронный код, оператор за оператором, он работает во многом подобно нашему списку дел:\n\n```js\n// поменять местами `x` и `y` (через временную переменную `z`)\nz = x;\nx = y;\ny = z;\n```\n\nЭти три оператора присваивания являются синхронными, поэтому `x = y` ожидает завершения `z = x`, а `y = z`, в свою очередь, ожидает завершения `x = y`. Другими словами, эти три утверждения связаны во времени с выполнением в определенном порядке, одно за другим. К счастью, нам не нужно беспокоиться о каких-либо подробностях, связанных с асинхронными событиями. Если бы мы это сделали, код быстро стал бы намного сложнее!\nИтак, если синхронное планирование мозга хорошо соотносится с операторами синхронного кода, насколько хорошо наш мозг справляется с планированием асинхронного кода?\n\nОказывается, то, как мы выражаем асинхронность (с обратными вызовами) в нашем коде, совсем не соответствует этому синхронному поведению планирования мозга.\n\nМожете ли вы на самом деле представить, что у вас есть ход мыслей, который планирует ваши дела таким образом?\n\n> \"Мне нужно в магазин, но по дороге я уверен, что мне позвонят, так что \"Привет, мама\", и пока она начнет говорить, я поищу адрес магазина по GPS, но это займет секунду, поэтому я убавлю радио, чтобы лучше слышать маму, а потом пойму, что забыл надеть куртку, а на улице холодно, но неважно, продолжаю ехать и разговариваю с мамой, а затем звон ремня безопасности напоминает мне о том, что нужно пристегнуться, так что «Да, мама, я пристегнут ремнем безопасности, я всегда пристегиваюсь!». Ах, наконец-то GPS получил направление, теперь...»\n\nКак бы нелепо это ни звучало как формулировка того, как мы планируем свой день и думаем о том, что делать и в каком порядке, тем не менее именно так работает наш мозг на функциональном уровне. Помните, что это не многозадачность, это просто быстрое переключение контекста.\n\nПричина, по которой нам, как разработчикам, трудно писать асинхронный код с событиями, особенно когда все, что у нас есть, это обратный вызов, заключается в том, что поток мыслей/планирование потока сознания неестественен для большинства из нас.\n\nМы думаем пошагово, но инструменты (обратные вызовы), доступные нам в коде, не выражаются пошагово, как только мы переходим от синхронного к асинхронному.\n\nИ **вот** почему так сложно точно написать и обосновать асинхронный код JS с обратными вызовами: потому что это не то, как работает наш мозг.\n\n**Примечание:** Единственное, что может быть хуже, чем не знать, почему некоторые коды не работают, — это не знать, почему они вообще работают! Это классический менталитет «карточного домика»: «он работает, но не знаю почему, поэтому никто его не трогает!» Возможно, вы слышали «Ад — это другие люди» (Сартр), а программистский мем — «Ад — это код других людей». Я искренне верю: «Ад - это не понимать собственный код». И обратные вызовы являются одним из основных виновников.\n\n### Вложенные/связанные обратные вызовы\n\nРассмотрим:\n\n```js\nlisten( \"click\", function handler(evt){\n\tsetTimeout( function request(){\n\t\tajax( \"http://some.url.1\", function response(text){\n\t\t\tif (text == \"hello\") {\n\t\t\t\thandler();\n\t\t\t}\n\t\t\telse if (text == \"world\") {\n\t\t\t\trequest();\n\t\t\t}\n\t\t} );\n\t}, 500) ;\n} );\n```\n\nЕсть хорошие шансы, что такой код узнаваем для вас. У нас есть цепочка из трех вложенных друг в друга функций, каждая из которых представляет собой шаг в асинхронной последовательности (задача, «процесс»).\n\nЭтот тип кода часто называют «ад обратных вызовов», а иногда также называют «пирамидой гибели» (из-за его треугольной формы, обращенной вбок из-за вложенного углубления).\n\nНо «ад обратных вызовов» на самом деле не имеет почти ничего общего с вложенностью/отступом. Это гораздо более глубокая проблема. Мы увидим, как и почему, в оставшейся части этой главы.\n\nВо-первых, мы ждем события «click», затем мы ждем срабатывания таймера, затем мы ждем возврата ответа Ajax, после чего он может повторить все это снова.\n\nНа первый взгляд может показаться, что этот код естественным образом связывает свою асинхронность с последовательным мозговым планированием.\n\nСначала (*сейчас*):\n\n```js\nlisten( \"..\", function handler(..){\n\t// ..\n} );\n```\n\n*позже*:\n\n```js\nsetTimeout( function request(..){\n\t// ..\n}, 500) ;\n```\n\n*еще позже*:\n\n```js\najax( \"..\", function response(..){\n\t// ..\n} );\n```\n\nНаконец (наиболее *позже*):\n\n```js\nif ( .. ) {\n\t// ..\n}\nelse ..\n```\n\nНо есть несколько проблем с линейными рассуждениями об этом коде.\n\nВо-первых, случайность примера состоит в том, что наши шаги находятся на следующих строках (1, 2, 3 и 4...). В настоящих асинхронных JS-программах часто присутствует гораздо больше шума, загромождающего вещи, которым мы должны ловко маневрировать в своем мозгу, когда переходим от одной функции к другой. Понимание асинхронного потока в таком перегруженном обратными вызовами коде не является невозможным, но это определенно не естественно и не легко, даже при большой практике.\n\nНо также есть и более глубокая ошибка, которая не очевидна только в этом примере кода. Позвольте мне придумать другой сценарий (псевдокодовый), чтобы проиллюстрировать его:\n\n```js\ndoA( function(){\n\tdoB();\n\n\tdoC( function(){\n\t\tdoD();\n\t} )\n\n\tdoE();\n} );\n\ndoF();\n```\n\nХотя опытные из вас правильно определят здесь истинный порядок операций, я держу пари, что на первый взгляд он более чем немного сбивает с толку, и для его достижения требуется несколько согласованных умственных циклов. Операции будут происходить в таком порядке:\n\n* `doA()`\n* `doF()`\n* `doB()`\n* `doC()`\n* `doE()`\n* `doD()`\n\nВы поняли это правильно, когда впервые взглянули на код?\n\nХорошо, некоторые из вас думают, что я несправедливо назвал свои функции, чтобы намеренно ввести вас в заблуждение. Клянусь, я просто называл в порядке появления сверху вниз. Но позвольте мне попробовать еще раз:\n\n```js\ndoA( function(){\n\tdoC();\n\n\tdoD( function(){\n\t\tdoF();\n\t} )\n\n\tdoE();\n} );\n\ndoB();\n```\n\nТеперь я назвал их в алфавитном порядке в порядке фактического выполнения. Но я все еще держу пари, даже имея опыт в этом сценарии, отслеживание в порядке «A -> B -> C -> D -> E -> F» не является естественным для многих из вас, читатели. Конечно, ваши глаза очень много прыгают вверх и вниз по фрагменту кода, верно?\n\nНо даже если все это кажется вам естественным, есть еще одна опасность, которая может нанести ущерб. Можете ли вы определить, что это такое?\n\nЧто, если `doA(..)` или `doD(..)` на самом деле не являются асинхронными, как мы, очевидно, предполагали? Ой, теперь порядок другой. Если они оба синхронизированы (и, возможно, только иногда, в зависимости от условий программы в то время), порядок теперь будет «A -> C -> D -> F -> E -> B».\n\nТот звук, который вы только что услышали на заднем плане, — это вздохи тысяч JS-разработчиков, которые только что столкнулись лицом к лицу.\n\nЯвляется ли вложение проблемой? Из-за этого так сложно отследить асинхронный поток? Это часть этого, конечно.\n\nНо позвольте мне переписать предыдущий пример вложенного события/тайм-аута/Ajax без использования вложенности:\n\n```js\nlisten( \"click\", handler );\n\nfunction handler() {\n\tsetTimeout( request, 500 );\n}\n\nfunction request(){\n\tajax( \"http://some.url.1\", response );\n}\n\nfunction response(text){\n\tif (text == \"hello\") {\n\t\thandler();\n\t}\n\telse if (text == \"world\") {\n\t\trequest();\n\t}\n}\n```\n\nЭта формулировка кода едва ли так узнаваема, как проблемы вложенности/отступов в его предыдущей форме, и все же она ничуть не менее подвержена «аду обратных вызовов». Почему?\n\nПо мере того, как мы переходим к линейному (последовательному) анализу этого кода, мы должны переходить от одной функции к следующей, к следующей и перемещаться по кодовой базе, чтобы «увидеть» поток последовательности. И помните, это упрощенный код в наилучшем случае. Все мы знаем, что базы кода реальных асинхронных JS-программ зачастую фантастически более запутаны, что на несколько порядков усложняет такие рассуждения.\n\nЕще одна вещь, на которую следует обратить внимание: чтобы связать шаги 2, 3 и 4 вместе, чтобы они выполнялись последовательно, единственный доступный способ, которые обратные вызовы дают нам, — это жестко закодировать шаг 2 в шаг 1, шаг 3 в шаг 2, шаг 4 в шаг 3, и так далее. Жесткое кодирование не обязательно плохо, если это действительно фиксированное условие, что шаг 2 всегда должен вести к шагу 3.\n\nНо жесткое кодирование определенно делает код немного более хрупким, поскольку оно не учитывает никаких ошибок, которые могут вызвать отклонение в последовательности шагов. Например, если шаг 2 терпит неудачу, шаг 3 никогда не достигается, и шаг 2 не повторяется, или выполняется переход к альтернативному потоку обработки ошибок и т.д.\n\nВсе эти проблемы вы *можете* вручную жестко прописать в каждом шаге, но этот код часто очень повторяющийся и не может быть повторно использован на других шагах или в других асинхронных потоках в вашей программе.\n\nНесмотря на то, что наш мозг может планировать ряд задач в последовательном порядке (это, затем это, затем это), событийный характер работы нашего мозга делает восстановление/повторение/разветвление управления потоком практически без усилий. Если вы бегаете по делам и понимаете, что оставили дома список покупок, день не заканчивается, потому что вы не спланировали это заранее. Ваш мозг легко обходит эту заминку: вы идете домой, берете список и сразу же направляетесь обратно в магазин.\n\nНо хрупкая природа жестко закодированных вручную обратных вызовов (даже с жестко запрограммированной обработкой ошибок) часто гораздо менее изящна. Как только вы в конечном итоге укажете (также известное как предварительное планирование) все различные возможности/пути, код станет настолько запутанным, что его трудно будет поддерживать или обновлять.\n\n**Вот это** и есть \"ад обратных вызовов\"! Вложение/отступы - это, по сути, второстепенное шоу, отвлекающий маневр.\n\nИ как будто всего этого недостаточно, мы даже не коснулись того, что происходит, когда две или более цепочек этих продолжений обратного вызова происходят *одновременно*, или когда третий шаг разветвляется на «параллельные» обратные вызовы с воротами или защелками, или... ОМГ, у меня мозг болит, а у тебя?!\n\nУлавливаете ли вы здесь, что наше последовательное, блокирующее поведение планирования мозга просто не очень хорошо отображается в асинхронном коде, ориентированном на обратных вызовах? Это первый существенный недостаток обратных вызовов, о котором нужно сказать: они выражают асинхронность в коде таким образом, что нашему мозгу приходится бороться только за то, чтобы синхронизироваться с ним (каламбур!).\n\n## Проблемы с доверием\n\nНесоответствие между последовательным мозговым планированием и асинхронным кодом JS, управляемым обратными вызовами, — это только часть проблемы с обратными вызовами. Есть кое-что гораздо более глубокое, о чем следует беспокоиться.\n\nДавайте еще раз вернемся к понятию callback-функции как продолжения (она же вторая половина) нашей программы:\n\n```js\n// A\najax( \"..\", function(..){\n\t// C\n} );\n// B\n```\n\n`// A` и `// B` происходят *сейчас* под непосредственным контролем основной JS-программы. Но `// C` откладывается, чтобы произойти *позже*, и находится под контролем другой стороны – в данном случае, функции `ajax(..)`. В общем смысле такая передача управления обычно не вызывает много проблем для программ.\n\nНо пусть вас не вводит в заблуждение его редкость, что этот переключатель управления не имеет большого значения. На самом деле, это одна из самых серьезных (и в то же время наиболее тонких) проблем проектирования, основанного на обратных вызовах. Он вращается вокруг идеи, что иногда `ajax(..)` (т.е. \"сторона\", которой вы передаете продолжение обратного вызова) не является функцией, которую вы написали или которой вы непосредственно управляете. Часто это утилита, предоставляемая третьей стороной.\n\nМы называем это «инверсией управления (IoC)», когда вы берете часть своей программы и передаете контроль над ее выполнением другому третьему лицу. Между вашим кодом и сторонней утилитой существует негласный «контракт» — набор вещей, которые вы ожидаете поддерживать.\n\n### Сказка о пяти обратных вызовах\n\nМожет быть не совсем очевидно, почему это так важно. Позвольте мне построить преувеличенный сценарий, чтобы проиллюстрировать опасности доверия в игре.\n\nПредставьте, что вы разработчик, которому поручено создать систему оплаты электронной торговли для сайта, продающего дорогие телевизоры. У вас уже есть все различные страницы системы оформления заказов, созданные просто отлично. На последней странице, когда пользователь нажимает «подтвердить», чтобы купить телевизор, вам нужно вызвать стороннюю функцию (предоставленную, скажем, какой-то аналитической компанией), чтобы можно было отследить продажу.\n\nВы заметили, что они предоставили то, что выглядит как утилита асинхронного отслеживания, вероятно, ради лучших практик производительности, что означает, что вам нужно передать функцию обратного вызова. В этом продолжении, которое вы передаете, у вас будет окончательный код, который снимает средства с кредитной карты клиента и отображает страницу благодарности.\n\nЭтот код может выглядеть так:\n\n```js\nanalytics.trackPurchase( purchaseData, function(){\n\tchargeCreditCard();\n\tdisplayThankyouPage();\n} );\n```\n\nДостаточно легко, верно? Вы пишете код, тестируете его, все работает, и вы запускаете его в производство. Все счастливы!\n\nПрошло полгода и никаких проблем. Вы почти забыли, что даже написали этот код. Однажды утром вы сидите в кофейне перед работой, небрежно наслаждаясь латте, когда вам звонит в панике начальник и настаивает, чтобы вы бросили кофе и сразу же бросились на работу.\n\nКогда вы приедете, вы узнаете, что с кредитной карты высокопоставленного клиента пять раз списали средства за один и тот же телевизор, и он, по понятным причинам, расстроен. Служба поддержки клиентов уже принесла извинения и обработала возврат средств. Но ваш босс требует знать, как это могло произойти. «Разве у нас нет тестов на подобные вещи!?»\n\nВы даже не помните код, который вы написали. Но вы копаетесь и начинаете пытаться выяснить, что могло пойти не так.\n\nПокопавшись в некоторых логах, вы приходите к выводу, что единственное объяснение в том, что утилита аналитики каким-то образом по какой-то причине вызвала ваш обратный вызов пять раз вместо одного. Ничто в их документации не упоминает ничего об этом.\n\nРазочарованный, вы связываетесь со службой поддержки, которая, конечно, так же удивлена, как и вы. Они соглашаются сообщить об этом своим разработчикам и обещают вернуться к вам. На следующий день вы получаете длинное электронное письмо с объяснением того, что они нашли, и сразу же пересылаете его своему боссу.\n\nСудя по всему, разработчики аналитической компании работали над некоторым экспериментальным кодом, который при определенных условиях будет повторять предоставленный обратный вызов один раз в секунду в течение пяти секунд, прежде чем произойдет сбой с тайм-аутом. Они никогда не собирались продвигать это в производство, но каким-то образом они это сделали, и они полностью смущены и извиняются. Они подробно рассказывают о том, как они определили сбой и что они сделают, чтобы это никогда не повторилось.\n\nЧто дальше?\n\nВы обсуждаете это со своим боссом, но он не чувствует себя особенно довольным положением вещей. Он настаивает, и вы неохотно соглашаетесь, что вы не можете больше доверять *им* (это то, что вас задело), и что вам нужно снова придумать, как защитить код проверки от такой уязвимости.\n\nПосле некоторой доработки вы реализуете простой специальный код, подобный приведенному ниже, который, похоже, устраивает команду:\n\n```js\nvar tracked = false;\n\nanalytics.trackPurchase( purchaseData, function(){\n\tif (!tracked) {\n\t\ttracked = true;\n\t\tchargeCreditCard();\n\t\tdisplayThankyouPage();\n\t}\n} );\n```\n\n**Примечание:** Это должно показаться вам знакомым из главы 1, потому что мы, по сути, создаем защелку для обработки, если произойдет несколько одновременных вызовов нашего обратного вызова.\n\nНо затем один из ваших QA-инженеров спрашивает: «Что произойдет, если они никогда не вызовут обратный вызов?» Упс. Никто из вас не думал об этом.\n\nВы начинаете искать кроличью нору и думаете обо всех возможных вещах, которые могут пойти не так, если они перезвонят вам. Вот примерный список возможных сбоев в работе аналитической утилиты:\n\n* Вызывать обратный вызов слишком рано (до того, как он будет отслежен)\n* Вызов обратного вызова слишком поздно (или никогда)\n* Вызовите обратный вызов слишком мало или слишком много раз (например, проблема, с которой вы столкнулись!)\n* Не удалось передать любую необходимую среду/параметры вашему обратному вызову\n* Проглотить любые ошибки/исключения, которые могут произойти\n* ...\n\nЭто должно показаться тревожным списком, потому что так оно и есть. Вы, вероятно, постепенно начинаете понимать, что вам придется изобретать очень много специальной логики **в каждом обратном вызове**, которая передается утилите, которой вы не уверены, что можете доверять.\n\nТеперь вы немного более полно осознаете, насколько адским является «ад обратных вызовов».\n\n### Не только чужой код\n\nНекоторые из вас могут сейчас скептически отнестись к тому, настолько ли это важно, как я это преподношу. Возможно, вы мало взаимодействуете с действительно сторонними утилитами. Возможно, вы используете версионные API или самостоятельно размещаете такие библиотеки, чтобы их поведение нельзя было изменить без вас.\n\nИтак, подумайте над этим: можете ли вы вообще *действительно* доверять утилитам, которыми вы теоретически управляете (в своей собственной кодовой базе)?\n\nПодумайте об этом так: большинство из нас согласны с тем, что, по крайней мере, в некоторой степени мы должны создавать свои собственные внутренние функции с некоторыми защитными проверками входных параметров, чтобы уменьшить/предотвратить непредвиденные проблемы.\n\nЧрезмерное доверие входным данным:\n```js\nfunction addNumbers(x,y) {\n // + перегружен приведением,\n // чтобы также быть конкатенацией строк,\n // поэтому эта операция не является строго безопасной\n // в зависимости от того, что передано.\n\treturn x + y;\n}\n\naddNumbers( 21, 21 );\t// 42\naddNumbers( 21, \"21\" );\t// \"2121\"\n```\n\nЗащита от ненадежного ввода:\n```js\nfunction addNumbers(x,y) {\n // обеспечиваем числовой ввод\n\tif (typeof x != \"number\" || typeof y != \"number\") {\n\t\tthrow Error( \"Bad parameters\" );\n\t}\n\n\t// если мы доберемся сюда, + безопасно выполнит числовое сложение\n\treturn x + y;\n}\n\naddNumbers( 21, 21 );\t// 42\naddNumbers( 21, \"21\" );\t// Error: \"Bad parameters\"\n```\n\nИли, возможно, все еще безопасно, но дружелюбнее:\n```js\nfunction addNumbers(x,y) {\n // обеспечиваем числовой ввод\n\tx = Number( x );\n\ty = Number( y );\n\n\t// + будет безопасно делать числовое сложение\n\treturn x + y;\n}\n\naddNumbers( 21, 21 );\t// 42\naddNumbers( 21, \"21\" );\t// 42\n```\n\nКак бы вы это ни делали, такого рода проверки/нормализации довольно распространены на входных данных функций, даже с кодом, которому мы теоретически полностью доверяем. Грубо говоря, это похоже на программный эквивалент геополитического принципа «Доверяй, но проверяй».\n\nИтак, не разумно ли, что мы должны делать то же самое с композицией обратных вызовов асинхронных функций, не только с действительно внешним кодом, но даже с кодом, который, как мы знаем, обычно «находится под нашим собственным контролем»? **Конечно, должны.**\n\nНо обратные вызовы на самом деле не предлагают ничего, чтобы помочь нам. Мы должны создавать весь этот механизм сами, и часто это приводит к большому количеству шаблонов/накладных расходов, которые мы повторяем для каждого отдельного асинхронного обратного вызова.\n\nСамая неприятная проблема с обратными вызовами — это *инверсия управления*, ведущая к полному разрыву всех этих линий доверия.\n\nЕсли у вас есть код, который использует обратные вызовы, особенно, но не исключительно, со сторонними утилитами, и вы еще не применяете какую-то логику смягчения для всех этих *инверсии управления* проблем с доверием, ваш код *имеет* ошибки в нем прямо сейчас, хотя они, возможно, еще не укусили вас. Скрытые ошибки остаются ошибками.\n\nДействительно ад.\n\n## Попытка сохранить обратные вызовы\n\nСуществует несколько вариантов дизайна обратного вызова, которые пытались решить некоторые (не все!) проблемы доверия, которые мы только что рассмотрели. Это доблестная, но обреченная попытка спасти шаблон обратного вызова от разрушения самого себя.\n\nНапример, что касается более изящной обработки ошибок, некоторые проекты API предусматривают раздельные обратные вызовы (один для уведомления об успехе, другой для уведомления об ошибке:\n\n```js\nfunction success(data) {\n\tconsole.log( data );\n}\n\nfunction failure(err) {\n\tconsole.error( err );\n}\n\najax( \"http://some.url.1\", success, failure );\n```\n\nВ API такого дизайна часто обработчик ошибок `failure()` является необязательным, и если он не указан, предполагается, что вы хотите проглотить ошибки. Фу.\n\n**Примечание.** Этот дизайн с разделенным обратным вызовом используется API ES6 Promise. Мы рассмотрим обещания ES6 более подробно в следующей главе.\n\nДругой распространенный шаблон обратного вызова называется «стиль с ошибкой в первую очередь» (иногда его также называют «стилем узла», поскольку это также соглашение, используемое почти во всех API-интерфейсах Node.js), где первый аргумент одного обратного вызова зарезервирован для объекта ошибки (если есть). В случае успеха этот аргумент будет пустым/ложным (и любые последующие аргументы будут данными об успехе), но если сигнализируется результат ошибки, первый аргумент устанавливается/истинный (и обычно больше ничего не передается):\n\n```js\nfunction response(err,data) {\n\t// ошибка?\n\tif (err) {\n\t\tconsole.error( err );\n\t}\n\t// в иных случаях успех\n\telse {\n\t\tconsole.log( data );\n\t}\n}\n\najax( \"http://some.url.1\", response );\n```\n\nВ обоих этих случаях следует соблюдать несколько вещей.\n\nВо-первых, это на самом деле не решило большинство проблем с доверием, как может показаться. В обратном вызове нет ничего, что предотвращало бы или отфильтровывало нежелательные повторные вызовы. Более того, сейчас дела обстоят еще хуже, потому что вы можете получить как сигналы об успехе, так и ошибки, или ни одного из них, и вам все равно придется кодировать любое из этих условий.\n\nКроме того, не упустите тот факт, что, хотя это стандартный шаблон, который вы можете использовать, он определенно более многословен и похож на шаблон без особого повторного использования, поэтому вы устанете вводить все это для каждого обратного вызова в вашем приложении.\n\nА как насчет проблемы доверия никогда не быть вызванным? Если это вызывает беспокойство (и, вероятно, должно быть!), вам, вероятно, потребуется установить тайм-аут, который отменяет событие. Вы можете сделать утилиту (показано только доказательство концепции), которая поможет вам в этом:\n\n```js\nfunction timeoutify(fn,delay) {\n\tvar intv = setTimeout( function(){\n\t\t\tintv = null;\n\t\t\tfn( new Error( \"Timeout!\" ) );\n\t\t}, delay )\n\t;\n\n\treturn function() {\n\t\t// timeout уже произошёл?\n\t\tif (intv) {\n\t\t\tclearTimeout( intv );\n\t\t\tfn.apply( this, [ null ].concat( [].slice.call( arguments ) ) );\n\t\t}\n\t};\n}\n```\n\nВот как можно его использовать:\n\n```js\n// использование обратного вызова в стиле «сначала ошибка»\nfunction foo(err,data) {\n\tif (err) {\n\t\tconsole.error( err );\n\t}\n\telse {\n\t\tconsole.log( data );\n\t}\n}\n\najax( \"http://some.url.1\", timeoutify( foo, 500 ) );\n```\n\nЕще одна проблема доверия называется «слишком рано». С точки зрения конкретного приложения это может фактически включать вызов до завершения какой-либо критической задачи. Но в более общем плане проблема проявляется в утилитах, которые могут либо вызывать предоставленный вами обратный вызов *сейчас* (синхронно) или *позже* (асинхронно).\n\nЭтот недетерминизм в отношении синхронного или асинхронного поведения почти всегда приводит к тому, что очень трудно отследить ошибки. В некоторых кругах вымышленный вызывающий безумие монстр по имени Залго используется для описания синхронно-асинхронных кошмаров. «Не выпускайте Залго!» — это распространенный крик, и он приводит к очень здравому совету: всегда вызывайте обратные вызовы асинхронно, даже если это «сразу же» на следующем этапе цикла событий, чтобы все обратные вызовы предсказуемо были асинхронными.\n\n**Примечание.** Дополнительную информацию о Zalgo см. в статье Орена Голана «Не выпускайте Zalgo!» (https://github.com/oren/oren.github.io/blob/master/posts/zalgo.md) и «Разработка API-интерфейсов для асинхронности» Исаака З. Шлютера (http://blog.izs.me/post/59142742143/designing-apis-for-asynchrony).\n\nРассмотрим:\n\n```js\nfunction result(data) {\n\tconsole.log( a );\n}\n\nvar a = 0;\n\najax( \"..pre-cached-url..\", result );\na++;\n```\n\nБудет ли этот код печатать «0» (вызов обратного вызова синхронизации) или «1» (вызов асинхронного обратного вызова)? Зависит... от условий.\n\nВы видите, как быстро непредсказуемость Zalgo может угрожать любой JS-программе. Таким образом, глупо звучащее «никогда не выпускайте Zalgo» на самом деле является невероятно распространенным и надежным советом. Всегда быть асинхронным.\n\nЧто, если вы не знаете, всегда ли рассматриваемый API будет выполняться асинхронно? Вы можете изобрести утилиту, подобную этой `asyncify(..)`, для доказательства концепции:\n\n```js\nfunction asyncify(fn) {\n\tvar orig_fn = fn,\n\t\tintv = setTimeout( function(){\n\t\t\tintv = null;\n\t\t\tif (fn) fn();\n\t\t}, 0 )\n\t;\n\n\tfn = null;\n\n\treturn function() {\n\t\t// срабатывает слишком быстро, прежде чем сработает таймер\n // `intv`, чтобы показать, что асинхронный ход прошел?\n\t\tif (intv) {\n\t\t\tfn = orig_fn.bind.apply(\n\t\t\t\torig_fn,\n // добавляем `this` обёртки к `bind(..)`\n // параметры вызова, а также каррирование любых\n // передается в параметрах\n\t\t\t\t[this].concat( [].slice.call( arguments ) )\n\t\t\t);\n\t\t}\n // уже асинхронно\n\t\telse {\n\t\t\t// вызвать исходную функцию\n\t\t\torig_fn.apply( this, arguments );\n\t\t}\n\t};\n}\n```\n\nМожно использовать `asyncify(..)` следующим образом:\n\n```js\nfunction result(data) {\n\tconsole.log( a );\n}\n\nvar a = 0;\n\najax( \"..pre-cached-url..\", asyncify( result ) );\na++;\n```\n\nНезависимо от того, находится ли запрос Ajax в кеше и разрешает попытку немедленного вызова обратного вызова, или его нужно получить по сети и, таким образом, выполнить позже асинхронно, этот код всегда будет выводить `1` вместо `0` -- `result(..)` не может не вызываться асинхронно, что означает, что `a++` имеет шанс запуститься раньше, чем `result(..)`.\n\nУра, еще одна проблема доверия решена! Но это неэффективно и еще больше раздувает шаблон, чтобы отягощать ваш проект.\n\nЭто просто история, снова и снова, с обратными вызовами. Они могут делать почти все, что вы хотите, но вы должны быть готовы много работать, чтобы получить это, и часто эти усилия намного больше, чем вы можете или должны потратить на такие рассуждения о коде.\n\nВозможно, вам понадобятся встроенные API или другие языковые механизмы для решения этих проблем. Наконец-то появился ES6 с отличными ответами, так что продолжайте читать!\n\n## Обзор\n\nОбратные вызовы — это фундаментальная единица асинхронности в JS. Но их недостаточно для меняющегося ландшафта асинхронного программирования по мере взросления JS.\n\nВо-первых, наш мозг планирует вещи последовательным, блокирующим, однопоточным семантическим способом, но обратные вызовы выражают асинхронный поток довольно нелинейным, непоследовательным образом, что значительно усложняет правильное рассмотрение такого кода. Плохие рассуждения о коде — это плохой код, который приводит к серьезным ошибкам.\n\nНам нужен способ выразить асинхронность в более синхронной, последовательной, блокирующей манере, как это делает наш мозг.\n\nВо-вторых, что более важно, обратные вызовы страдают от *инверсии управления*, поскольку они неявно передают управление другой стороне (часто сторонней утилите, не находящейся под вашим контролем!) для вызова *продолжения* вашей программы. Эта передача управления приводит нас к тревожному списку проблем с доверием, например, вызывается ли обратный вызов чаще, чем мы ожидаем.\n\nИзобретение специальной логики для решения этих проблем с доверием возможно, но это сложнее, чем должно быть, и в результате получается более громоздкий и трудный для сопровождения код, а также код, который, вероятно, недостаточно защищен от этих опасностей, пока вы явно не укусите его ошибки.\n\nНам нужно обобщенное решение **всех проблем с доверием**, которое можно будет повторно использовать для любого количества обратных вызовов, которое мы создадим, без дополнительных шаблонных накладных расходов.\n\nНам нужно что-то лучше, чем обратные вызовы. До сих пор они хорошо служили нам, но «будущее» JavaScript требует более сложных и эффективных асинхронных шаблонов. В последующих главах этой книги мы углубимся в эти зарождающиеся эволюции.\n"
},
{
"path": "async & performance/ch3.md",
"content": "# Вы не знаете JS: Асинхронность и производительность\n# Глава 3: Промисы\n\nВ главе 2 мы определили две главные категории недостатков в использовании колбеков для того, чтобы выразить асинхронность программы и управлять параллельной обработкой: отсутствие последовательного кода и надежности. Теперь, когда мы разобрали эти проблемы досконально, настало время обратить внимание на шаблоны, которые позволят их решить.\n\nПроблема, с которой мы хотим начать - *инверсия управления (IoC)*, это то доверие, которое так тяжело сохранять и так легко потерять.\n\nВспомните как мы обработали *продолжение (continuation)* нашей программы в колбек-функции и передали этот колбек в другую часть кода (потенциально даже во внешний код) и просто скрестили пальцы на удачу, что вызов этого колбэка произойдет корректно.\n\nМы сделали это поскольку мы хотели этим сказать, \"вот то, что должно выполниться *позже*, после того, как завершится текущий шаг программы.\"\n\nНо что если бы мы смогли разинверсировать эту *инверсию управления*? Что если вместо передачи продолжения программы в другой код мы могли бы ожидать от него дать нам возможность узнать когда его задача завершится и затем наш код мог бы решить, что делать дальше?\n\nЭта концепция называется **Промисы**.\n\nПромисы начинают быстро покорять мир JS, поскольку разработчики и создатели спецификаций в равной мере отчаянно ищут возможность избавиться от безумия ада колбеков в своим коде/дизайне. На самом деле, многие новые асинхронные API добавляются в платформу JS/DOM будучи построенным на промисах. Так что, возможно, это неплохая идея уйти с головой и изучить их, Вы так не думаете!?\n\n**Примечание:** Слово \"сразу\" будет часто использоваться в этой главе, в основном указывая на какое-либо действие по разрешению промиса. Однако, в фактически всех случаях, \"сразу\" в терминах поведения очереди заданий означает (см. главу 1) не строго синхронное значение *сейчас*.\n\n## Что такое промис?\n\nКогда разработчики решают изучить новую технологию или шаблон, обычно их первым шагом будет \"Покажите мне код!\". Это вполне естественно для нас просто броситься в омут с головой и изучать по ходу.\n\nОднако бывает так, что одних только API недостаточно, чтобы понять определённые абстракции. Промисы — это как раз тот инструмент, где по тому, как их используют, сразу видно: понимает ли человек, для чего они нужны и как работают, или просто изучил и использует API.\n\nТак что перед тем как я покажу код с промисами, я хочу объяснить целиком и полностью что такое промисы концептуально. Я надеюсь, что это быстрее направит вас на истинный путь по мере того как вы будете постигать теорию интеграции промисов в свой асинхронный поток.\n\nПомня об этом, давайте взглянем на две различные аналогии того что *есть* промисы.\n\n### Будущее значение\n\nПредставьте такой сценарий: Я подхожу к стойке в ресторане быстрого питания и делаю заказ на чизбургер. Я даю кассиру $1.47. Разместив и оплатив свой заказ, я сделал запрос возврата *значения* (чизбургера). Я открыл транзакцию.\n\nНо частенько, чизбургер не сразу мне доступен. Кассир даем мне что-то взамен моего чизбургера: чек с номером заказа в нем. Этот номер заказа - это IOU-*обещание* (промис) (Я должен вам (\"I owe you\")) которое гарантирует, что в итоге я должен получить свой чизбургер.\n\nТак что я храню мой чек и номер заказа. Я знаю, что оно представляет собой мой *будущий чизбургер*, поэтому мне не надо о этом больше волноваться кроме ощущения голода!\n\nПока я жду Я могу заниматься другими делами, например отправить текстовое сообщение другу, говорящее: \"Эй, как насчет присоединиться ко мне за обедом? Я собираюсь съесть чизбургер.\"\n\nЯ уже рассуждаю о своем *будущем чизбургере*, несмотря на то, что у меня еще его нет. Мой мозг способен так делать потому что он воспринимает номер заказа как заменитель чизбургера. Такой заменитель фактически делает значение *независимым от времени*. Это и есть **будущее значение**.\n\nВ итоге я слышу \"Заказ 113!\" и радостно иду обратно к стойке с чеком в руках. Я передаю чек кассиру и взамен беру свой чизбургер.\n\nДругими словами, как только мое *будущее значение* было готово, я обменял промис значения на само значение.\n\nНо есть и еще один возможный исход. Они называют мой номер заказа, но когда я подхожу, чтобы забрать свой чизбургер кассир с сожалению сообщает мне: \"Мне жаль, но мы судя по всему остались без чизбургеров.\" Оставив в стороне разочарование покупателя в таком сценарии на секундочку, мы можем заметить важную характеристику *будущих значений*: они могут сигнализировать либо о завершении, либо об отказе.\n\nКаждый раз, когда я заказываю чизбургер, я знаю что либо я рано или поздно получу чизбургер, либо получу печальные новости о нехватке чизбургеров и я должен буду придумать что-то другое на обед.\n\n**Примечание:** В реальном коде процесс не такой простой, потому что метафорически номер заказа может никогда не быть назван, и в таком случае мы остаемся в неразрешим состоянии вечно. Мы еще вернемся к этому случаю позже.\n\n#### Значения Сейчас и Позже\n\nВсё это может прозвучать слишком абстрактно для применения в вашем коде. Так давайте внесем больше конкретики.\n\nОднако, перед тем, как мы представим как работают промисы подобным образом, мы собираемся покопаться в коде, который мы уже умеем понимать -- колбеки! -- чтобы понять как обрабатывать эти *будущие значения*.\n\nКогда вы пишете код, чтобы обработать каким-либо образом некое значение, например выполнив математические вычисления над `числом`, то осознанно или нет, вы предполагаете кое-что очень фундаментальное об этом значении, а именно, что это - уже конкретное значение *сейчас*:\n\n```js\nvar x, y = 2;\n\nconsole.log( x + y ); // NaN <-- потому что в `x` еще не установлено значение\n```\n\nОперация `x + y` предполагает, что оба `x` и `y` уже заданы. В терминах, которые мы вскоре разъясним, мы полагаем что значения `x` и `y` уже *разрешены* (т.е. с уж определенными значениями).\n\nБудет абсурдом ожидать, что оператор `+` сам по себе каким-то магическим образом сможет определить и ждать до тех пор, пока оба `x` и `y` разрешатся (т.е. будут готовы), и только затем выполнит операцию. Это может привести к хаосу в программе, если одни выражения закончатся *сейчас*, а другие закончатся *позже*, не так ли?\n\nКак вы сможете потенциально рассуждать о связях между двумя выражениями, если одно из них (или оба) могут быть еще не завершены? Если выражение 2 полагается на то, что выражение 1 будет завершено, то возможны два исхода: либо выражение 1 закончится прямо *сейчас* и всё благополучно продолжится, либо statement 1 еще не завершено, и в итоге выражение 2 приведет к ошибке.\n\nЕсли такие вещи звучат знакомо после главы 1, хорошо!\n\nДавайте вернемся к нашей математической операции `x + y`. Представьте, что был бы путь сказать, \"Сложи `x` и `y`, но если кто-то из них еще не подготовлен, просто подожди пока это не произойдет. Сложи их как можно скорее.\"\n\nВаш мозг возможно сразу переключился на колбеки. Хорошо, итак...\n\n```js\nfunction add(getX,getY,cb) {\n\tvar x, y;\n\tgetX( function(xVal){\n\t\tx = xVal;\n\t\t// оба готовы?\n\t\tif (y != undefined) {\n\t\t\tcb( x + y );\t// отправить сумму\n\t\t}\n\t} );\n\tgetY( function(yVal){\n\t\ty = yVal;\n\t\t// оба готовы?\n\t\tif (x != undefined) {\n\t\t\tcb( x + y );\t// отправить сумму\n\t\t}\n\t} );\n}\n\n// `fetchX()` and `fetchY()` синхронные или асинхронные\n// функции\nadd( fetchX, fetchY, function(sum){\n\tconsole.log( sum ); // это было легко, ага?\n} );\n```\n\nПодождите минутку, чтобы позволить красоте (или отсутствию таковой) этого кусочка кода уложиться в голове (терпеливо насвистываю).\n\nХотя это уродство и несомненное, тут есть кое-что очень важное на заметку об этом асинхронном шаблоне.\n\nВ этом кусочке кода, мы трактовали `x` и `y` как будущие значения и мы выразили операцию `add(..)` так, что она (снаружи) не заботится о том, доступен ли `x` или `y` прямо сейчас или нет. Другими словами, он нормализует *сейчас* и *потом* таким образом, что мы можем положиться на предсказуемый результат операции `add(..)`.\n\nПри использовании `add(..)`, которая временно консистентна, она ведет себя одинаково *сейчас* и *потом* - такой асинхронный код легче себе представлять.\n\nВыражаясь более просто: чтобы обработать согласованно оба *сейчас* и *потом*, мы оба их превращаем в *потом*: все операции становятся асинхронными.\n\nКонечно, этот грубый подход, основанный на колбеках, оставляет желать намного лучшего. Это всего-лишь первый крошечный шаг к пониманию преимуществ представления *будущих значений* без беспокойств о временном аспекте того, доступны они или нет.\n\n#### Промис как значение\n\nМы определенно углубимся в детали промисов позже в этой главе, поэтому не волнуйтесь если что-то тут покажется запутанным, а просто мельком взгляните на то, как мы выразим пример `x + y` через `Promise`ы:\n\n```js\nfunction add(xPromise,yPromise) {\n\t// `Promise.all([ .. ])` принимает массив промисов\n\t// и возвращает новый промис, который ожидает завершения всех переданных\n\treturn Promise.all( [xPromise, yPromise] )\n\n\t// когда промис разрешен, давайте возьмем\n\t// полученные значения `X` и `Y` и сложим их.\n\t.then( function(values){\n\t\t// `values` - массив сообщений от\n\t\t// ранее разрешенных промисов\n\t\treturn values[0] + values[1];\n\t} );\n}\n\n// `fetchX()` и `fetchY()` возвращают промисы для\n// своих соответствующих значений, которые могут быть готовы\n// *сейчас* или *позже*.\nadd( fetchX(), fetchY() )\n\n// мы получаем обратно промис с суммой этих\n// двух чисел.\n// теперь мы выполняем в цепочке вызов `then(..)`, чтобы дождаться разрешения\n// этого возвращенного промиса.\n.then( function(sum){\n\tconsole.log( sum ); // это намного легче!\n} );\n```\n\nВ этом кусочке кода есть два слоя промисов.\n\n`fetchX()` и `fetchY()` вызываются напрямую и возвращаемые или значения (промисы!) передаются в `add(..)`. Внутренние значения, которые представляют эти промисы, могут быть готовы *сейчас* или *позже*, но каждый промис приводит свое поведение к тому, чтобы вести себя одинаково вне зависимости ни о чего. Мы рассуждаем о значениях `X` и `Y` во время-независимой манере. Они - *будущие значения*.\n\nВторой уровень - это промис, который создается в `add(..)` (через `Promise.all([ .. ])`) и возвращается, и который мы ожидаем вызвав `then(..)`. Когда операция `add(..)` завершена, наше *будущее значение* `sum` готово и можем вывести его на экран. Внутри `add(..)` мы скрываем всю логику ожидания *будущих значений* `X` и `Y`.\n\n**Примечание** Внутри `add(..)`, вызов `Promise.all([ .. ])` создает промис (который ждем разрешения `promiseX` и `promiseY`). Цепочечный Вызов `.then(..)` создает еще один промис, который сразу же разрешает строку `return values[0] + values[1]` (с результатом сложения). Таким образом, вызов `then(..)`, который мы поместили в конец цепочки вызова `add(..)` в конце фрагмента кода, в сущности работает с этим вторым возвращенным промисом, а не с первым, созданным `Promise.all([ .. ])`. Также, хотя мы и не добавили ничего в конец цепочки второго `then(..)`, он также создает еще один промис, невзирая на то, хотим мы его использовать или нет. Эту штуку с цепочками промисов мы поясним в деталях позже в этой главе.\n\nПрямо как с заказами чизбургеров, есть такая же вероятность того, что промис разрешится отказом вместо исполнения. В отличие от исполненного промиса, где значение всегда программно задано, значение при отказе, обычно называемое \"причиной отказа\", может быть установлено либо напрямую в логике программы, либо может явиться результатом исключения времени выполнения.\n\nС использованием промисов, вызов `then(..)` фактически может принимать две функции: первую - для завершения (как показано ранее), а вторую - для отказа:\n\n```js\nadd( fetchX(), fetchY() )\n.then(\n\t// обработчик завершения\n\tfunction(sum) {\n\t\tconsole.log( sum );\n\t},\n\t// обработчик отказа\n\tfunction(err) {\n\t\tconsole.error( err ); // облом!\n\t}\n);\n```\n\nЕсли что-то пошло не так при получении `X` или `Y`, или что-то каким-либо образом привело к сбою во время сложения, промис, который возвращается из `add(..)` - отвергается (завершается отказом) и второй колбек-обработчик ошибок, переданный в `then(..)` получит значение отказа из промиса.\n\nПоскольку промисы инкапсулируют в себе состояние, не зависящее от времени, с ожиданием завершения или отказа получения значения операции снаружи, промис сам по себе является независимым от времени и потому промисы можно компоновать (составлять) предсказуемым образом независимо от времени или внутреннего результата.\n\nБолее того, как только промис разрешен, он остается таковым навсегда, он становится *неизменяемым значением* в этот момент и может потом быть *обследован* столько раз, сколько нужно.\n\n**Примечание** Поскольку промис является неизменяемым внешне как только он разрешен, то теперь можно безопасно передавать его куда угодно зная, что он не может быть изменен случайно или злонамеренно. Это особенно верно в связи с тем, что наблюдать за разрешением одного и того же промиса могут разные стороны. Невозможно повлиять на возможность одной стороны наблюдать за разрешением промиса другой стороной. Неизменяемость может прозвучать как какая-то научная тема, но на самом деле это один из самых фундаментальных и важных аспектов дизайна промисов и не должен быть рассмотрен походя мимоходом.\n\nЭто один из самых мощных и важных ключей к пониманию промисов. Проделав достаточно большую работу, вы могли бы специально добиться того же эффекта используя только композицию из уродливых колбеков, но это не особенно эффективная стратегия, особенно потому, что вы вынуждены делать это снова и снова.\n\nПромисы - это легко повторяемый механизм инкапсуляции и совмещения *будущих значений*.\n\n### Событие завершения\n\nКак мы только что видели, одиночный промис ведет себя как *будущее значение*. Но есть и другой путь представлять разрешение промиса: как механизм потокового управления, временнОе \"это-затем-то\" для двух и более шагов в асинхронной задаче.\n\nДавайте представим вызов функции `foo(..)` для выполнения некой задачи. Мы либо не знаем ничего о ее внутренней реализации, или просто не беспокоимся об этом. Она может завершить задачу сразу или может занять некоторое время.\n\nНам просто нужно знать когда завершится `foo(..)`, чтобы мы могли двигаться к нашей следующей задаче. Другими словами, нам нужна возможность получить оповещение о завершении `foo(..)`, чтобы мы могли *продолжить* выполнение.\n\nВ обычном случае в JavaScript если вам нужно получить оповещение, вы вероятно подумаете об этом с точки зрения событий. Таким образом мы можем переформулировать нашу потребность в оповещении как необходимость получить событие *завершения* (или *продолжения*), инициированное функцией `foo(..)`.\n\n**Примечание** Назовете ли вы это \"событием завершения\" или \"событием продолжения\" зависит от вашей точки зрения. На чем больше смещен фокус: на том что случится в `foo(..)` или на том что произойдет *после* завершения `foo(..)`? Обе точки зрения точны и полезны. Уведомление о событии сообщает нам, что `foo(..)` *завершилась*, но также и то, что можно *продолжить* выполнение следующего шага. Безусловно, тот колбек, который вы передаете, чтобы он был вызван для уведомления о событии, сам по себе то, что мы ранее назвали *продолжение*. Потому что *событие завершения* немного более сфокусировано на `foo(..)`, что больше привлекает наше внимание в настоящий момент, мы все же чуть больше отдаем предпочтение *событию завершения* до конца этого текста.\n\nС использованием колбеков, \"уведомлением\" будет наш колбек, вызванный задачей (`foo(..)`). Но с промисами, мы переворачиваем отношения и ожидаем, что можем ждать событие от `foo(..)` и как только получим его может действовать соответственно.\n\nСперва, обратите внимание на этот псевдокод:\n\n```js\nfoo(x) {\n\t// начинаем выполнять что-то, что требует времени\n}\n\nfoo( 42 )\n\non (foo \"completion\") {\n\t// теперь мы можем выполнить следующий шаг!\n}\n\non (foo \"error\") {\n\t// ой, что-то пошло не так в `foo(..)`\n}\n```\n\nМы вызываем `foo(..)`, а затем настраиваем два обработчика событий, один для `\"completion\"` (завершение), а другой для `\"error\"` (сбоя)-- двух возможных *окончательных* исхода вызова `foo(..)`. По сути, не похоже, что `foo(..)` вообще в курсе о том, что вызывающий код подписался на эти события, что ведет к очень хорошему *разделению обязанностей*.\n\nК сожалению, такой код потребовал бы некоторой \"магии\" окружения JS, которое не существует (и которое бы весьма вероятно было бы немного непрактичным). Вот более естественный путь, которым мы может это выразить в JS:\n\n```js\nfunction foo(x) {\n\t// начнем выполнять что-нибудь, требующее времени\n\n\t// создадим обработчик оповещения о событии `listener`,\n\t// чтобы его можно было вернуть из функции\n\n\treturn listener;\n}\n\nvar evt = foo( 42 );\n\nevt.on( \"completion\", function(){\n\t// теперь мы можем выполнить следующий шаг\n} );\n\nevt.on( \"failure\", function(err){\n\t// ой, что-то пошло не так в `foo(..)`\n} );\n```\n\n`foo(..)` специально создает возможность подписки на события, которую можно вернуть из функции и вызывающий код получает и регистрирует два обработчик событий для нее.\n\nИнверсия обычного колбек-ориентированного кода должно быть очевидна и это намеренно. Вместо передачи колбеков `foo(..)`, она возвращает возможность получения событий, которую мы назвали `evt`, которая получает колбеки.\n\nНо если вы вспомните главу 2, колбеки сами по себе являются *инверсией управления* (IoC). Таким образом инвертируя шаблон колбека, в действительности получаем *инверсия инверсии* или *разинверсия управления*, возвращая управление обратно вызывающему коду, туда где оно должно было быть изначально.\n\nОдно важное преимущество - это то, что многим отдельным частях кода можно дать возможность получать события и они все смогут быть независимо уведомлены о том, когда завершится `foo(..)`, чтобы выполнить последующий код после ее завершения:\n\n```js\nvar evt = foo( 42 );\n\n// пусть `bar(..)` получает уведомление о завершении `foo(..)`\nbar( evt );\n\n// пусть `baz(..)` также получает уведомление о завершении `foo(..)`\nbaz( evt );\n```\n\n*Разинверсия управления* открывает возможность лучшего *разделения обязанностей*, где функциям `bar(..)` и `baz(..)` не нужно быть вовлеченными в то, как вызывается `foo(..)`. Аналогично, функции `foo(..)` не нужно ни знать, ни беспокоиться о том, что `bar(..)` и `baz(..)` существуют или ждут уведомления о завершении `foo(..)`.\n\nФактически, это объект `evt` - это нейтральный сторонний посредник между отдельными функциональными обязанностями.\n\n#### \"События\" промиса\n\nКак вы можете теперь предположить, возможность получения события `evt` - это аналогия для промиса.\n\nВ промисо-ориентированном подходе предыдущий блок кода мог бы содержать `foo(..)`, создающую и возвращающую экземпляр `Promise`, и этот промис был бы передан в `bar(..)` и `baz(..)`.\n\n**Примечание** \"События\" разрешения промиса, который мы ждем, не являются событиями в строгом смысле (хотя они определенно ведут себя как события в этом сценарии), и они не просто вызывают `\"completion\"` или `\"error\"`. Вместо этого, мы используем `then(..)`, чтобы зарегистрировать событие `\"then\"`. Или чуть более точно, `then(..)` регистрирует событие(я) `\"fulfillment\"` (выполнения) и/или `\"rejection\"` (отказа), хотя мы и не видим эти термины в явном виде в коде.\n\nВзгляните:\n\n```js\nfunction foo(x) {\n\t// начнем выполнять что-нибудь, требующее времени\n\n\t// создает и возвращаем промис\n\treturn new Promise( function(resolve,reject){\n\t\t// в итоге вызвать `resolve(..)` или `reject(..)`,\n\t\t// которые являются колбеками разрешения для промиса.\n\t} );\n}\n\nvar p = foo( 42 );\n\nbar( p );\n\nbaz( p );\n```\n\n**Примечание** Шаблон, показанный с `new Promise( function(..){ .. } )` - обычно называется[\"открытый конструктор (revealing constructor)\"](http://domenic.me/2014/02/13/the-revealing-constructor-pattern/). Переданная функция выполняется сразу (а не асинхронно отложенным вызовом, как колбеки в `then(..)`) и туда передаются два параметра, которые в этом случае называются `resolve` и `reject`. Это функции разрешения промиса. `resolve(..)` обычно сигнализирует о выполнении, а `reject(..)` - об отказе.\n\nВы вероятно сможете угадать, как выглядят внутри `bar(..)` и `baz(..)`:\n\n```js\nfunction bar(fooPromise) {\n\t// ждать завершения `foo(..)`\n\tfooPromise.then(\n\t\tfunction(){\n\t\t\t// `foo(..)` теперь закончена, так что\n\t\t\t// выполняем задачу `bar(..)`\n\t\t},\n\t\tfunction(){\n\t\t\t// ой, что-то пошло не так в `foo(..)`\n\t\t}\n\t);\n}\n\n// то же самое для `baz(..)`\n```\n\nРазрешение промиса не обязательно требует отправки сообщения, как это было когда мы исследовали промисы как *будущие значения*. Это может быть просто сигнал управления потоком, как это было в предыдущем блоке кода.\n\nЕще один путь добиться этого:\n\n```js\nfunction bar() {\n\t// `foo(..)` определенно завершилась, поэтому\n\t// выполняем задачу `bar(..)`\n}\n\nfunction oopsBar() {\n\t// ой, что-то пошло не так в `foo(..)`,\n\t// поэтому `bar(..)` не был запущен\n}\n\n// то же самое для `baz()` и `oopsBaz()`\n\nvar p = foo( 42 );\n\np.then( bar, oopsBar );\n\np.then( baz, oopsBaz );\n```\n\n**Примечание** Если вы уже видели раньше промис-ориентированный код, у вас может возникнуть соблазн поверить, что две последних строки этого кода можно записать как `p.then( .. ).then( .. )`, используя цепочку вызовов вместо `p.then(..); p.then(..)`. Это было бы совершенно другое поведение, будьте осторожны! Прямо сейчас разница может быть неочевидна, но это на самом деле совершенно другой асинхронный шаблон, нежели мы видели до сих пор: разделение/разветвление. Не волнуйтесь! Мы вернемся к этому позже в этой главе.\n\nВместо передачи промиса `p` в `bar(..)` и `baz(..)`, мы используем промис, чтобы управлять когда `bar(..)` и `baz(..)` будут выполнены, если вообще будут. Главное отличие - в обработке ошибок.\n\nВ подходе, использованном в первом примере кода, `bar(..)` вызывается независимо от того, `foo(..)` или нет, и в нем выполняется своя собственная логика возврата, если получается сообщение о том, что в `foo(..)` произошел сбой. Очевидно, что то же самое верно и для `baz(..)`.\n\nВо втором примере кода, `bar(..)` вызывается только если `foo(..)` завершена, а иначе вызывается `oopsBar(..)`. То же самое для `baz(..)`.\n\nНи один из этих подходов не является *корректным* сам по себе. Будут случаи, когда один будет предпочитаем другому.\n\nВ любом случае, промис `p`, который возвращается из `foo(..)`, используется для контроля того, что произойдет дальше.\n\nБолее того, факт того, что оба примера кода заканчиваются вызовом `then(..)` дважды для одного и того же промиса `p` иллюстрирует рассказанное ранее, то что промисы (если уже разрешены) остаются в том же состоянии разрешения (завершение или отказ) навсегда и могут быть позже исследованы столько раз, сколько нужно.\n\nВсякий раз когда `p` разрешается, следующий шаг будет одним и тем же, и *сейчас*, и *позже*.\n\n## Утиная типизация и наличие then\n\nВ краю промисов важной деталью является то, как узнать наверняка, что какое-то значение - подлинный промис или нет. Или более прямо, ведет ли себя это значение как промис?\n\nУчитывая, что промисы создаются используя синтаксис `new Promise(..)`, вы можете подумать, что `p instanceof Promise` будет приемлемой проверкой. Но к сожалению есть ряд причин, указывающих что этого совершенно недостаточно.\n\nПреимущественно, вы можете получить значение промиса от другого окна браузера (iframe и т.д.), у которого есть свой собственный промис, отличный от того, который в текущем окне/фрейме, и такая проверка на определение промиса была бы неудачной.\n\nБолее того, библиотека или фреймворк могут избрать путь распространения своих собственных промисов и не использовать нативную реализацию ES6 `Promise`. По сути, вы можете вполне успешно пользоваться промисами из библиотек в старых браузерах, у которых совсем нет промисов.\n\nКогда мы будем обсуждать процессы разрешения промисов позже в этой главе, станет более очевидным почему ненативное, но выглядящее как промис значение будет все еще очень важно опознавать и употреблять. Но на текущий момент, просто поверьте на слово, что это важная часть головоломки.\n\nПоэтому, было определено, что путем определения промиса (или чего-то, что ведет себя как промис) будет определение чего-либо, называемого \"then-содержащим\", как любой объект или функция, у которой есть метод `then(..)`. Предполагается, что любое такое значение является промисо-совместимым then-содержащим.\n\nОбщее термин для \"проверок типа\", которые делают предположения о \"типе\" значения на основании его формы (какие в нем есть свойства), называется \"утиная типизация\": \"Если это выглядит как утка и крякает как утка, значит это должно быть утка\" (см. раздел *Типы и грамматика* в этой серии книг). Таким образом утиная проверка на наличие then условно будет такой:\n\n```js\nif (\n\tp !== null &&\n\t(\n\t\ttypeof p === \"object\" ||\n\t\ttypeof p === \"function\"\n\t) &&\n\ttypeof p.then === \"function\"\n) {\n\t// предположим, что это содержит then!\n}\nelse {\n\t// не содержит then\n}\n```\n\nТьфу! Оставляя в стороне тот факт, что эта логика немного уродливая для использования в различных местах, тут происходит кое-что поглубже и более проблематичное.\n\nЕсли вы попробуете завершить промис из любого значения объекта/функции, у которых оказалась функция `then(..)`, но вы не хотели интерпретировать его как промис/then-содержащее значение, вам не повезло, потому что он будет автоматически распознан как then-содержащее значение и обработан по специальным правилам (см. позднее в этой главе).\n\nЭто верно даже если вы не осознавали, что у этого значения есть `then(..)`. Например:\n\n```js\nvar o = { then: function(){} };\n\n// сделать чтобы у `v` в качестве `[[Prototype]]` было `o`\nvar v = Object.create( o );\n\nv.someStuff = \"cool\";\nv.otherStuff = \"not so cool\";\n\nv.hasOwnProperty( \"then\" );\t\t// false\n```\n\n`v` совсем не выглядит как промис или then-содержащее значение. Это просто обычный объект с некоторыми свойствами. Возможно вы просто хотите передавать это значение везде как любой другой объект.\n\nНо скрытно от вас, `v` также связано `[[Prototype]]` (см. *this и прототипы объектов* книгу в серии книг) с другим объектом `o`, в котором как оказалось есть `then(..)`. Таким образом проверка утиной типизации на then-содержащее значение подумает и предположит, что `v` - это then-содержащее значение. Ой-ей.\n\nТут даже всё может быть не так явно намеренным:\n\n```js\nObject.prototype.then = function(){};\nArray.prototype.then = function(){};\n\nvar v1 = { hello: \"world\" };\nvar v2 = [ \"Hello\", \"World\" ];\n```\n\nОба `v1` и `v2` будут определены как then-содержащие значения. Вы не можете контролировать или предсказать добавит ли какой-либо код случайно или злонамеренно `then(..)` в `Object.prototype`, `Array.prototype` или любой из других встроенных прототипов. И если то, что указано является функцией, которая не вызывает ни один из своих параметров как колбеки, то любой промис, разрешенный с таким значением просто незаметно повиснет навсегда! Безумие.\n\nЗвучит неправдоподобно или невероятно? Возможно.\n\nНо не забывайте, что есть несколько хорошо известных не-промис библиотек, существовавших в сообществе до ES6, в кторым случайно оказался метод, названный `then(..)`. Некоторые из этих библиотек решили переименовать свои собственные методы, чтобы избежать коллизий (которые удручают!). Другие просто были отнесены к несчастливому статусу \"несовместим с кодом, использующим промисы\" в награду за их неспособность измениться, чтобы убраться с дороги.\n\nПо стандартам решили украсть ранее незарезервированное и совершенно универсально звучащее имя свойства `then`, что означает что ни одно значение (или любой из его делегатoв), прошлое, настоящее или будущее, не может иметь функцию `then(..)` намеренно или случайно, в противном случае это значение будут путать с then-содержащим в промис-системах, что вероятно повлечет за собой создание ошибок, которые будет действительно трудно отловить.\n\n**Предупреждение:** Мне не нравится как мы закончили материал об утиной типизации then-содержащих значений для определения промисов. Были и другие варианты, такие как \"брэндинг\" или даже \"анти-брэндинг\"; то, что у нас было, казалось наихудшим компромиссом. Но это совсем не конец света. Then-содержащая утиная типизация может быть и полезной как мы увидим позже. Просто будьте осторожны, так как такая утиная типизация по then может быть опасна если она некорректно определяет что-то как промис, которое таковым не является.\n\n## Доверие к промису\n\nСейчас мы увидели две сильные аналогии, которые объясняют различные аспекты того, что могут делать промисы для нашего асинхронного кода. Но если мы тут и остановимся, мы возможно упустим единственную важнейшую характеристику, которую предоставляет шаблон промисов: доверие.\n\nВ то время как аналогии *будущие значения* и *события завершения* в явном виде происходят в тех шаблонах кода которые мы изучили, будет не совсем очевидно почему или как промисы разработаны, чтобы решить все проблемы доверия *инверсии управления*, которые мы изложили в секции \"Проблемы с доверием\" главы 2. Но слегка покопавшись мы можем вскрыть некоторые важные гарантии, которые восстановят уверенность в асинхронном кодировании, которую разрушила глава 2!\n\nДавайте начнем с рассмотрения проблем доверия при разработке в стиле одних только колбеков. Когда вы передаете колбек в функцию `foo(..)`, она может:\n\n* Вызвать колбек слишком рано\n* Вызвать колбек слишком поздно (или никогда)\n* Вызвать колбек слишком мало раз или слишком много раз\n* Провалить передачу в колбек любых необходимых окружения/параметров\n* Проглотить любые ошибки/исключения, которые могут произойти\n\nХарактеристики промисов намеренно разработаны, чтобы обеспечить полезные, воспроизводимые ответы на все эти проблемы.\n\n### Вызывая слишком рано\n\nВ первую очередь, эта проблема в том, могут ли проявиться в коде Залго-подобные эффекты (см. главу 2), где иногда задача завершается синхронно, а иногда - асинхронно, что может приводить к состоянию гонки.\n\nПромисы по определению не могут быть подвержены этой проблеме, потому что даже сразу завершенный промис (типа `new Promise(function(resolve){ resolve(42); })`) нельзя *исследовать* синхронно.\n\nТо есть, когда вы вызываете `then(..)` у промиса, даже если промис уже был разрешен, колбек, который вы передаете в `then(..)` **всегда** будет вызван асинхронно (детальнее об этом см. \"Задачи\" в главе 1).\n\nБольше не нужно вставлять свои собственные костыли с `setTimeout(..,0)`. Промисы не допускают Залго автоматически.\n\n### Вызывая слишком поздно\n\nАналогично предыдущему пункту, колбеки наблюдения, зарегистрированные в `then(..)` промиса автоматически планируются к вызову когда вызван либо `resolve(..)`, либо `reject(..)` посредством кода создания промиса. Эти запланированные колбеки будут предсказуемо вызваны в следующий асинхронный момент (см. \"Задачи\" в главе 1).\n\nСинхронное наблюдение тут невозможно, следовательно невозможно запустить синхронную цепочку задач таким образом, чтобы на практике \"отложить\" вызов другого колбека ожидаемым образом. То есть, когда промис разрешен, все зарегистрированные для`then(..)` колбеки будут по порядку вызваны, сразу же при следующей асинхронной возможности (снова, см. \"Задачи\" в главе 1) и ничто, что происходит внутри одного из этих колбеков не может повлиять или задержать вызов остальных колбеков.\n\nНапример:\n\n```js\np.then( function(){\n\tp.then( function(){\n\t\tconsole.log( \"C\" );\n\t} );\n\tconsole.log( \"A\" );\n} );\np.then( function(){\n\tconsole.log( \"B\" );\n} );\n// A B C\n```\n\nЗдесь, `\"C\"` не может прервать и предшествовать `\"B\"`, в силу того как промисам было определено работать.\n\n#### Хитрости планировщика промисов\n\nВажно отметить, впрочем, что есть масса нюансов планировщика, когда относительный порядок между колбеками, выстроенными в цепочки двух отдельных промисов, не является надежно предсказуемым.\n\nЕсли два промиса `p1` и `p2` оба уже разрешены, то будет истиной, что `p1.then(..); p2.then(..)` закончится вызовов колбека(ов) для `p1` до колбеков для `p2`. Но есть некоторые хитрые случаи, когда это может быть и не так, такие как следующий:\n\n```js\nvar p3 = new Promise( function(resolve,reject){\n\tresolve( \"B\" );\n} );\n\nvar p1 = new Promise( function(resolve,reject){\n\tresolve( p3 );\n} );\n\nvar p2 = new Promise( function(resolve,reject){\n\tresolve( \"A\" );\n} );\n\np1.then( function(v){\n\tconsole.log( v );\n} );\n\np2.then( function(v){\n\tconsole.log( v );\n} );\n\n// A B <-- не B A как вы могли бы ожидать\n```\n\nМы расскажем об этом позже, но как вы видите `p1` разрешен не с непосредственным значением, а с еще одним промисом `p3`, который сам разрешен со значением `\"B\"`. Указанное поведение - это *распаковать* `p3` внутри `p1`, но асинхронно, таким образом колбек(и) `p1` *позади* колбека(ов) `p2` в очереди асинхронных задач (см. главу 1).\n\nЧтобы избежать таких хитрых кошмаров, вам никогда не следует полагаться на что-либо связанное с порядком/шедулингом колбеков в промисах. На самом деле, хорошей практикой будет не писать код таким образом, чтобы порядок многочисленных колбеков имел хоть какие-то значение. Избегайте этого если сможете.\n\n### Колбек, который никогда не был вызван\n\nЭто - очень распространенная проблема. Она решаема несколькими путями с промисами.\n\nВо-первых, ничто (ни даже JS-ошибка) не может повлиять на уведомление вас от промиса о своем разрешении (если он разрешен). Если вы указываете оба колбека как для завершения, так и для сбоя при создании промиса и промис разрешается,то один из этих двух колбеков всегда будет вызван.\n\nКонечно, если ваши колбеки сами содержат JS-ошибки, вы можете не получить ожидаемый результат, но колбек и в самом деле будет вызван. Мы расскажем позже как получить уведомление об ошибке в своем колбеке, потому что даже эти ошибки не проглатываются.\n\nНо что если сам промис никогда не будет разрешен тем или иным путем? Даже для такой ситуации у промисов есть ответ используя абстракцию более высокого порядка, называемую \"гонка\":\n\n```js\n// функция с промисом по тайм-ауту\nfunction timeoutPromise(delay) {\n\treturn new Promise( function(resolve,reject){\n\t\tsetTimeout( function(){\n\t\t\treject( \"Тайм-аут!\" );\n\t\t}, delay );\n\t} );\n}\n\n// настройка тайм-аута для `foo()`\nPromise.race( [\n\tfoo(),\t\t\t\t\t// попробовать вызвать `foo()`\n\ttimeoutPromise( 3000 )\t// дать на это 3 секунды\n] )\n.then(\n\tfunction(){\n\t\t// `foo(..)` выполнился успешно и вовремя!\n\t},\n\tfunction(err){\n\t\t// либо `foo()` завершилась неудачно, либо она\n\t\t// не завершилась вовремя, так что проверьте\n\t\t// `err` чтобы определить причину\n\t}\n);\n```\n\nЕсть еще много нюансов, которые можно учесть при рассмотрении этого шаблона промисов с тайм-аутом, но мы вернемся к этом позже.\n\nВажно, что мы можем гарантированно просигнализировать о результате `foo()`, чтобы предотвратить зависание нашей программы бесконечно.\n\n### Вызывая слишком мало или много раз\n\nПо определению, *один* - это подходящее число раз, которое колбек должен быть вызван. Случай \"слишком мало\" будет означать ноль вызовов, что то же самое что и случай \"никогда\", который мы только что рассмотрели.\n\nСлучай \"слишком много\" легко объяснить. Промисы определены таким образом, что могут быть разрешены только один раз. Если по каким-либо причинам код создания промиса попытается вызвать `resolve(..)` или `reject(..)` несколько раз или попытается вызвать их обоих, то промис примет во внимание только первый вызов и молча проигнорирует любые последующие попытки.\n\nПоскольку промис можно разрешить лишь раз, любые зарегистрированные колбеки `then(..)` будут вызваны только по разу (каждый).\n\nКонечно, если зарегистрируете один и ото же колбек более одного раза, (т.е., `p.then(f); p.then(f);`), он будет вызван столько раз, сколько был зарегистрирован. Гарантия того, что функция ответа будет вызвана только раз не препятствует вам выстрелить себе в ногу.\n\n### Сбой при передаче параметров/окружения\n\nУ промисов может быть не больше одного значения разрешения (завершение или отказ).\n\nЕсли вы не разрешаете промис явно с конкретным значением, значение будет `undefined`, как и обычно в таких случаях в JS. Но если ли значение или нет, оно всегда будет передавно во все зарегистрированные (и корректные: завершение или отказ) колбеки, либо *сейчас*, или в будущем.\n\nЧто-то, о чем нужно знать: если вы вызываете `resolve(..)` или `reject(..)` с несколькими параметрами, все параметры, которые следуют за первым, будут молча проигнорированы. Хотя это и может выглядеть как нарушение гарантии, которую мы только что описали, это не совсем так потому что it это представляет собой недопустимое использование механизма промисов. Другие недопустимые случаи использования API (такие как вызов `resolve(..)` несколько раз) *защищены* похожим образом, таким образом поведение промисов тут будет консистентным (если не немного расстраивающим).\n\nЕсли вы хотите передать несколько значений, вы должны обернуть их в еще одно одиночное значение, которое вы и передадите, такое как `array` (массив) или `object` (объект).\n\nЧто касается окружения, функции в JS всегда сохраняют свое замыкание области видимости, в которой они определены (см. *Область видимости и замыкания* в этой серии книг), так что у них, конечно, остается доступ к тому окружающему состоянию, которое вы предоставляете. Конечно, то же самое справедливо и для подхода с одними колбеками, поэтому это не какое-то особенная выгодная добавка от промисов, но это гарантия, на которую мы можем тем ни менее положиться.\n\n### Проглатывание любых ошибок/исключений\n\nВ основе, это просто переформулирование предыдущего пункта. Если вы отклоняете промис с определенной *причиной* (т.е. сообщением об ошибке), то это значение будете передано в колбек(и) отказа.\n\nНо здесь есть нечто гораздо большее. Если в любой точке создания промиса или при исследовании его разрешения произойдет исключение JS, такое как `TypeError` или `ReferenceError`, такое исключение будет захвачено и это заставит завершиться с отказом рассматриваемый промис.\n\nНапример:\n\n```js\nvar p = new Promise( function(resolve,reject){\n\tfoo.bar();\t// `foo` не определена поэтому ошибка!\n\tresolve( 42 );\t// никогда не достигнет этой точки :(\n} );\n\np.then(\n\tfunction fulfilled(){\n\t\t// никогда не достигнет этой точки :(\n\t},\n\tfunction rejected(err){\n\t\t// `err` будет объектом исключения `TypeError`\n\t\t// произошедшим на строке `foo.bar()`.\n\t}\n);\n```\n\nJS-исключение, которое возникает от `foo.bar()`, становится отказом промиса, который вы можете захватить и обработать.\n\nЭто - важная деталь, потому что она успешно решает еще один потенциальный Залго-момент, который заключается в том, что эти ошибки повлечь синхронную реакцию тогда как не-ошибки будут асинхронными. Даже JS-исключения промисы превращают в асинхронное поведение, тем самым значительно уменьшая шансы появления состояния гонки.\n\nНо что произойдет если промис завершен, а произошло JS-исключение во время обработки результата (в зарегистрированном колбеке `then(..)`)? Даже такие исключения не будут потеряны, но вы можете немного удивиться тому, как они обрабатываются, пока не вникните немного глубже в это:\n\n```js\nvar p = new Promise( function(resolve,reject){\n\tresolve( 42 );\n} );\n\np.then(\n\tfunction fulfilled(msg){\n\t\tfoo.bar();\n\t\tconsole.log( msg );\t// никогда не достигнет этой точки :(\n\t},\n\tfunction rejected(err){\n\t\t// никогда не достигнет и этой точки :(\n\t}\n);\n```\n\nПодождите-ка, тут похоже, что исключение от `foo.bar()` и в самом деле проглочено. Без паники, оно не пропало. Но кое-что внутри не так, а именно то, что мы не смогли получить уведомление об этом. Вызов `p.then(..)` сам по себе возвращает другой промис и это *тот самый* промис, который будет отклонен с исключением `TypeError`.\n\nТак почему же он не может просто вызвать обработчик ошибок, который мы там объявили? Похоже, что логичное объяснение лежит на поверхности. Но оно нарушило бы основополагающий принцип промисов - **неизменность** после разрешения. `p` уже была завершена со значением `42`, так что она не может быть позднее изменена на отказ только потому, что возникла ошибка в наблюдающей функции разрешения `p`.\n\nКроме нарушения принципа, такое поведение может нанести ущерб, если скажем было несколько зарегистрированных колбеков `then(..)` для промиса `p`, поскольку тогда некоторые будут вызваны, а другие - нет, и это было очень непрозрачно в плане причины почему так произошло.\n\n### Надежный промис?\n\nЕсть одна последняя деталь, чтобы понять как установить доверие, основанное на шаблоне промисов.\n\nБез сомнения вы заметили, что промисы не избавились от колбеков полностью. Они просто поменяли место, куда передается колбек. Вместо передачи колбека в `foo(..)`, мы получаем *нечто* (предположительно настоящий промис) обратно из `foo(..)`, и мы взамен передаем колбек в это *нечто*.\n\nНо почему это было бы надежнее, чем просто колбеки сами по себе? Как мы можем быть уверены в точ, что *нечто*, что мы получаем в ответ на самом деле надежный промис? Не является ли всё это в сущности просто карточным домиком, где мы можем доверять только потому, что мы уже доверяем?\n\nОдна из самых важных, но часто незаслуженно обойденных вниманием деталей промисов - это то, что у них есть решение также и этой проблемы. Включенное в нативную реализацию ES6 `Promise` - `Promise.resolve(..)`.\n\nЕсли вы передаете непосредственное, не являющееся ни промисом, ни then-содержащим, значение в `Promise.resolve(..)`, вы получили промис, который завершен с этим значением. Другими словами, эти два промиса `p1` и `p2` будут вести себя практически идентично:\n\n```js\nvar p1 = new Promise( function(resolve,reject){\n\tresolve( 42 );\n} );\n\nvar p2 = Promise.resolve( 42 );\n```\n\nНо если вы передадите настоящий промис в `Promise.resolve(..)`, вы просто получите тот же промис обратно:\n\n```js\nvar p1 = Promise.resolve( 42 );\n\nvar p2 = Promise.resolve( p1 );\n\np1 === p2; // true\n```\n\nЧто еще более важно, если вы передаете не-промис then-содержащее значение в `Promise.resolve(..)`, оно попытается распаковать это значение, и распаковка будет продолжаться до тех пор, пока не будет извлечено конкретное окончательное не-промис значение.\n\nПомните наше прошедшее обсуждение then-содержащих?\n\nРассмотрите:\n\n```js\nvar p = {\n\tthen: function(cb) {\n\t\tcb( 42 );\n\t}\n};\n\n// это сработает, но только благодаря удаче\np\n.then(\n\tfunction fulfilled(val){\n\t\tconsole.log( val ); // 42\n\t},\n\tfunction rejected(err){\n\t\t// никогда не достигнет этой точки\n\t}\n);\n```\n\nЭто `p` - then-содержащее, но это не настоящий промис. К счастью, оно разумное, как и большинство какие бывают. Но что если вы получите в ответ что-то, что выглядит как-то так:\n\n```js\nvar p = {\n\tthen: function(cb,errcb) {\n\t\tcb( 42 );\n\t\terrcb( \"злобный смех\" );\n\t}\n};\n\np\n.then(\n\tfunction fulfilled(val){\n\t\tconsole.log( val ); // 42\n\t},\n\tfunction rejected(err){\n\t\t// ой, не должно было сработать\n\t\tconsole.log( err ); // злобный смех\n\t}\n);\n```\n\nЭто `p` - then-содержащее, но оно не ведет себя как хороший промис. Вредоносное ли оно? Или просто игнорирует то, как должны работать промисы? Это не важно, если честно. В любом случае, оно не надежно в том виде, как есть.\n\nТем ни менее, мы может передать любую их этих версий `p` в `Promise.resolve(..)`, и мы получим нормализованный, безопасный результат, который и ожидаем:\n\n```js\nPromise.resolve( p )\n.then(\n\tfunction fulfilled(val){\n\t\tconsole.log( val ); // 42\n\t},\n\tfunction rejected(err){\n\t\t// никогда не достигнет этой точки\n\t}\n);\n```\n\n`Promise.resolve(..)` примет любые then-содержащие аргументы, и распакует их в их не-then-содержащее значение. Но вы получите обратно из `Promise.resolve(..)` настоящий, подлинный промис, **тот, которому вы можете доверять**. Если то, что вы передали, уже является настоящим промисом, вы просто получите его же обратно, так что нет никаких недостатков в том, что фильтровать через `Promise.resolve(..)`, чтобы получить надежность.\n\nДопустим мы вызываем `foo(..)` и не уверены, что можем доверять его возвращаемому значению в том, что оно является правильным промисом, но мы знаем, что оно как минимум then-содержащее. `Promise.resolve(..)` даст нам надежную обертку в виде промиса, которую можно использовать в цепочке:\n\n```js\n// не делайте так:\nfoo( 42 )\n.then( function(v){\n\tconsole.log( v );\n} );\n\n// вместо этого, делайте так:\nPromise.resolve( foo( 42 ) )\n.then( function(v){\n\tconsole.log( v );\n} );\n```\n\n**Примечание** Еще один выгодный побочный эффект оборачивания `Promise.resolve(..)` вокруг любого возвращаемого из функции значения (then-содержащей или нет) - это то, что это легкий путь к приведению этого вызова функции к правильно ведущей себя асинхронной задаче. Если `foo(42)` иногда возвращает непосредственное значение, а иногда промис, `Promise.resolve( foo(42) )` следит за тем, чтобы это всегда был в результате промис. И избегая Залго приводит к намного лучшему коду.\n\n### Построенное доверие\n\nНадеюсь, что предыдущая дискуссия теперь полностью \"разрешает\" (каламбур) в вашим мозгу факт, почему промис надежен, и более важно, почему это доверие так критично для построения надежного, поддерживаемого ПО.\n\nМожете ли вы писать асинхронный код в JS без какой-либо надежности? Конечно можете. Мы, JS-разработчики, пишем асинхронный код не имея ничего кроме колбеков уже почти два десятилетия.\n\nНо как только вы начинаете задавать вопросы просто о том, насколько вы можете доверять механизмам, на которые вы опираетесь, в самом деле быть предсказуемыми и надежными, вы начинаете осознавать, что у колбеков довольно шаткий фундамент доверия.\n\nПромисы - это шаблон, который дополняет колбеки надежной семантикой, так что поведение становится более разумным и надежным. Сделав разинверсию *инверсии управления* колбеками, мы передаем управление надежной системе (промисам), которая была специально разработана, чтобы привнести здравый смысл в нашу асинхронность.\n\n## Цепочечный поток\n\nМы уже намекали на это пару раз, но промисы - это не только механизм для одношаговой операции типа *это-затем-то*. Это строительный блок, конечно, но оказывается мы можем связать немного промисов вместе для представления последовательности асинхронных шагов.\n\nКлюч к тому, чтобы это сработало, построен на двух видах поведения, присущих промисам:\n\n* Каждый раз как вы вызываете `then(..)` у промиса, он создает и возвращает новый промис, с которым мы можем составить *цепочку*.\n* Какое бы значение вы ни вернули из колбека завершения `then(..)` (первый параметр) - оно автоматически устанавливается как set как результата нормального завершения промиса *в цепочке* (из первого пункта).\n\nДавайте сперва проиллюстрируем что это значит, а *затем* (then, туту игра слов) вы выведем как это помодет нам создавать асинхронные последовательности управления потоком. Рассмотрим следующее:\n\n```js\nvar p = Promise.resolve( 21 );\n\nvar p2 = p.then( function(v){\n\tconsole.log( v );\t// 21\n\n\t// завершить `p2` со значением `42`\n\treturn v * 2;\n} );\n\n// составляем цепочку с `p2`\np2.then( function(v){\n\tconsole.log( v );\t// 42\n} );\n```\n\nВозвращая `v * 2` (i.e., `42`), мы завершаем промис `p2` с успешным результатом, который создал и вернул первый вызов `then(..)`. Когда происходит вызов `then(..)` у `p2`, он получает результат из выражения `return v * 2`. Конечно, `p2.then(..)` создает еще один промис, который мы можем сохранить в переменной `p3`.\n\nНо немного раздражает необходимость создавать промежуточную переменную `p2` (или `p3`, и т.д.). К счастью, мы легко можем объединить их в цепочку:\n\n```js\nvar p = Promise.resolve( 21 );\n\np\n.then( function(v){\n\tconsole.log( v );\t// 21\n\n\t// вернуть результат промиса в цепочке со значением `42`\n\treturn v * 2;\n} )\n// вот и промис в цепочке\n.then( function(v){\n\tconsole.log( v );\t// 42\n} );\n```\n\nТаким образом теперь первый `then(..)` - это первый шаг в асинхронной последовательности, а второй `then(..)` - это второй шаг. Это может продолжаться столь долго, сколь вам надо это расширять. Просто продолжайте цепочку от предыдущего `then(..)` автоматически созданным промисом.\n\nНо здесь нет кое-чего. Что если мы хотим, чтобы шаг 2 ждал пока шаг 1 выполнит что-то асинхронное? Мы используем выражение `return` для возврата значения сразу, которое немедленно и завершает промис в цепочке.\n\nКлюч к тому, чтобы заставить последовательность промисов быть истинно асинхронной на каждом шаге - это вспомнить как работает `Promise.resolve(..)` когда то, что вы передаете ему - это промис или then-содержащее вместо конечного значения. `Promise.resolve(..)` прямо возвращает полученный настоящий промис или распаковывает значение полученного then-содержащего и движется рекурсивно пока может распаковывать then-содержащие.\n\nТакой же вид распаковки происходит если вы используете в `return` then-содержащее или промис из обработчика завершения (или отказа). Рассмотрим:\n\n```js\nvar p = Promise.resolve( 21 );\n\np.then( function(v){\n\tconsole.log( v );\t// 21\n\n\t// создаем промис и возвращаем его\n\treturn new Promise( function(resolve,reject){\n\t\t// завершение со значением `42`\n\t\tresolve( v * 2 );\n\t} );\n} )\n.then( function(v){\n\tconsole.log( v );\t// 42\n} );\n```\n\nНесмотря на то, что мы обернули `42` в промис, который вернули, оно все еще распаковано и оказалось в качестве разрешения промиса в цепочке, такого как второй `then(..)`, который тем ни менее получил `42`. Если мы добавим асинхронность для этого оборачивающего промиса, все всё еще будет работать по-прежнему одинаково:\n\n```js\nvar p = Promise.resolve( 21 );\n\np.then( function(v){\n\tconsole.log( v );\t// 21\n\n\t// создаем промис и возвращаем его\n\treturn new Promise( function(resolve,reject){\n\t\t// добавляем асинхронность!\n\t\tsetTimeout( function(){\n\t\t\t// завершение со значением `42`\n\t\t\tresolve( v * 2 );\n\t\t}, 100 );\n\t} );\n} )\n.then( function(v){\n\t// запускается после задержки 100мс на предыдущем шаге\n\tconsole.log( v );\t// 42\n} );\n```\n\nЭто невероятно мощно! Теперь мы можем строить последовательность со сколь угодно большим количеством асинхронных шагов и каждый шаг может задержать следующий шаг (или не задержать!), если необходимо.\n\nКонечно, значение, передаваемое из шага в шаг в этих примерах, не обязательное. Если вы не вернете явное значение, будет предполагаться неявное значение `undefined` и промисы все еще будут в цепочке таким же образом. Разрешение каждого промиса, таким образом, является просто сигналом перейти к следующему шагу.\n\nДля дальней иллюстрации цепочки, давайте обобщим создание промиса с задержкой (без вывода сообщений о завершении) в функцию, которую мы можем переиспользовать для нескольких шагов:\n\n```js\nfunction delay(time) {\n\treturn new Promise( function(resolve,reject){\n\t\tsetTimeout( resolve, time );\n\t} );\n}\n\ndelay( 100 ) // шаг 1\n.then( function STEP2(){\n\tconsole.log( \"шаг 2 (после 100мс)\" );\n\treturn delay( 200 );\n} )\n.then( function STEP3(){\n\tconsole.log( \"шаг 3 (после еще 200мс)\" );\n} )\n.then( function STEP4(){\n\tconsole.log( \"шаг 4 (следующая задача)\" );\n\treturn delay( 50 );\n} )\n.then( function STEP5(){\n\tconsole.log( \"шаг 5 (после еще 50мс)\" );\n} )\n...\n```\n\nВызов `delay(200)` создает промис, который завершится через 200мс, а затем вы вернем его из первого колбека завершения `then(..)`, который приведет ко второму промису от `then(..)`, чтобы подождать этот 200мс-промис.\n\n**Примечание** Как было описано, технически есть два промиса в этом обмене: промис с 200мс-задержкой и промис в цепочке, к которому присоединяется второй `then(..)`. Но возможно вам будет проще мысленно объединить эти два промиса вместе, потому что механизм промисов автоматически объединим их состояния для вас. В этом отношении, вы можете думать о `return delay(200)` как о создании промиса, который заменяет ранее возвращенный промис в цепочке.\n\nХотя, если честно, последовательности задержек без передачи полезной нагрузки не очень полезный пример управления потоком промисов. Давайте взглянем на сценарий, который выглядит чуточку более практично.\n\nВместо таймеров, давайте рассмотрим возможность создания Ajax-запросов:\n\n```js\n// предположим есть функция `ajax( {url}, {callback} )`\n\n// Ajax с учетом промисов\nfunction request(url) {\n\treturn new Promise( function(resolve,reject){\n\t\t// колбек `ajax(..)` должен стать нашей\n\t\t// функцией `resolve(..)` промиса\n\t\tajax( url, resolve );\n\t} );\n}\n```\n\nСначала мы определяем функцию `request(..)`, которая создает промис для представления завершения вызова `ajax(..)`:\n\n```js\nrequest( \"http://some.url.1/\" )\n.then( function(response1){\n\treturn request( \"http://some.url.2/?v=\" + response1 );\n} )\n.then( function(response2){\n\tconsole.log( response2 );\n} );\n```\n\n**Примечание** Разработчики часто сталкиваются с ситуациями, когда они хотят получить асинхронное управление потоком промисов для функций, которые сами по себе не поддерживают промисы (как `ajax(..)` здесь, который ожидает на входе колбек). Хотя нативный механизм ES6 `Promise` не решает автоматически этот шаблон за нас, практически все промис-библиотеки *решают*. Они обычно называют этот процесс \"lifting\" (поднятие) или \"promisifying\" (промисифицирование) или вариации на тему. Мы вернемся к этой технике позже.\n\nИспользуя `request(..)`, умеющий возвращать промис, мы неявно создаем первый шаг в нашей цепочке вызывая его с первым URL, и объединяем в цепочку этот возвращенный промис с первым `then(..)`.\n\nКак только возвращается `response1`, мы используем это значение чтобы создать второй URL и выполнить второй вызов `request(..)`. Этот второй промис из `request(..)` - возвращен `return`ом таким образом, что третий шаг в нашем асинхронном контроле потока ждет завершения этого Ajax-вызова. Наконец, мы выводим `response2` как только он возвращен.\n\nЦепочка промисов, которую мы создали - не только управление потоком, которое отражает многошаговую асинхронную последовательность, но и также действует как канал сообщений для передачи их от шага к шагу.\n\nЧто если что-то пойдет не так в одном из шагов цепочки промисов? Ошибка/исключение соединены со своим промисом, что означает, что есть возможность поймать такую ошибку в любом месте цепочки и такой захват действует как бы как \"сброс\" цепочки обратно к нормальному функционированию в этой точке:\n\n```js\n// шаг 1:\nrequest( \"http://some.url.1/\" )\n\n// шаг 2:\n.then( function(response1){\n\tfoo.bar(); // undefined, ошибка!\n\n\t// никогда не достигнет этой точки\n\treturn request( \"http://some.url.2/?v=\" + response1 );\n} )\n\n// шаг 3:\n.then(\n\tfunction fulfilled(response2){\n\t\t// никогда не достигнет этой точки\n\t},\n\t// обработчик отказа, чтобы поймать ошибку\n\tfunction rejected(err){\n\t\tconsole.log( err );\t// `TypeError` из-за ошибки на `foo.bar()`\n\t\treturn 42;\n\t}\n)\n\n// шаг 4:\n.then( function(msg){\n\tconsole.log( msg );\t\t// 42\n} );\n```\n\nКогда происходит ошибка на шаге 2, обработчик отказа в шаге 3 ловит ее. Возвращаемое значение (`42` в этом примере кода), если таковое есть, из обработчика отказа завершает промис для следующего шага (4), так, чтобы цепочка вернулось обратно в состояние завершения.\n\n**Примечание** Как мы уже говорили ранее, при возврате промиса из обработчика завершения, этот промис не обернут и может задержать следующий шаг. Это также верно при возврате промисов из обработчиков отказа, так что если `return 42` на шаге 3 вернет вместо этого промис, этот промис может задержать шаг 4. Выброшенное исключение внутри либо обработчика завершения, либо отказа в вызове `then(..)` приведет к тому, что следующий (в цепочке) промис будет немедленно отвергнут с этим же исключением.\n\nЕсли вы вызовете `then(..)` у промиса и передадите только обработчик завершения в него, будет подставлен неявный обработчик отказов:\n\n```js\nvar p = new Promise( function(resolve,reject){\n\treject( \"Ой\" );\n} );\n\nvar p2 = p.then(\n\tfunction fulfilled(){\n\t\t// никогда не достигнет этой точки\n\t}\n\t// неявный обработчик отказа, если явно не указан или\n\t// передано любое другое значение - не-функция\n\t// function(err) {\n\t// throw err;\n\t// }\n);\n```\n\nКак видите, неявный обработчик отказа просто повторно бросает ту же ошибку, что в итоге вынуждает `p2` (промис в цепочке) завершиться отказом с той же самой причиной в виде ошибки. По сути, это позволяет ошибке продолжить путешествовать по цепочке промисов до тех пор, пока не встретится явно заданный обработчик отказа.\n\n**Примечание** Мы расскажем подробнее об обработке ошибок в промисах немного позже, потому что есть и другие нюансы, о которым стоит побеспокоиться.\n\nЕсли в `then(..)` не передана валидная функция в качестве параметра обработчика завершения, также будет подставлен неявный обработчик:\n\n```js\nvar p = Promise.resolve( 42 );\n\np.then(\n\t// неявный обработчик завершения, если явно не указан или\n\t// передано любое другое значение - не-функция\n\t// function(v) {\n\t// return v;\n\t// }\n\tnull,\n\tfunction rejected(err){\n\t\t// никогда не достигнет этой точки\n\t}\n);\n```\n\nКак видите, обработчик завершения по умолчанию просто передает полученное значение на следующий шаг (промис).\n\n**Примечание** Шаблон `then(null,function(err){ .. })`, обрабатывающий только отказы (если есть), но позволяющий пропускать далее завершения, имеет сокращенную форму в API: `catch(function(err){ .. })`. Мы рассмотрим `catch(..)` более полно в следующем разделе.\n\nДавайте вкратце рассмотрим присущие промисам типы поведения, которые позволяют организовать цепочечное управление потоком:\n\n* Вызов `then(..)` с одним промисом автоматически создает новый промис в качестве возвращаемого значения вызова.\n* Внутри обработчиков завершения/отказа, если вы возвращаете значение или бросается исключение, новый возвращенный промис (который можно присоединить к цепочке) разрешается соответственно с тем же результатом.\n* Если обработчик завершения или отказа возвращают промис, он не обернут, таким образом как бы он не разрешился, это станет разрешением промиса в цепочке, возвращенного из текущего `then(..)`.\n\nХотя цепочечное управление потоком полезное, возможно будет более точным представлять его как побочный эффект того, как промисы объединяются (составляются) вместе, нежели как основной функционал. Как мы подробно обсуждали уже несколько раз, промисы нормализуют асинхронность и скрывают состояние значения, зависимого от времени, и это *то*, что позволяет нам объединять их в цепочки таким удобным способом.\n\nОпределенно, последовательная выразительность цепочки (это-then-это-then-это...) - это большое улучшение по сравнению с запутанным клубком колбеков, как мы уже выяснили в главе 2. Но все еще есть изрядный объем шаблона (`then(..)` и `function(){ .. }`), через который нужно продираться. В следующей главе мы увидим значительно более приятный шаблон для выразительной организации последовательного управления потоком с помощью генераторов.\n\n### Терминология: Разрешить (Resolve), Завершить (Fulfill) и Отвергнуть (Reject)\n\nСуществует небольшая путаница в терминах \"разрешить (resolve)\", \"Завершить (fulfill)\" и \"отвергнуть (reject)\", которую нам необходимо прояснить до того, как вы погрузитесь слишком глубоко в изучении промисов. Давайте сначала рассмотрим конструктор `Promise(..)`:\n\n```js\nvar p = new Promise( function(X,Y){\n\t// X() для завершения\n\t// Y() для отказа\n} );\n```\n\nКак видите, переданы два колбека (здесь помечены как `X` и `Y`). Первый *обычно* используется для отметки того, что промис завершен, а второй *всегда* помечает промис как отвергнутый. Но о чем это \"обычно\" и что это означает для точного именования этих параметров?\n\nВ конечном счете, это только ваш код и имена идентификаторов не интерпретируются JS-движком как что-то значимое, так что *технически* это не имеет значения; `foo(..)` и `bar(..)` одинаково функциональны. Но слова, которыми вы пользуетесь, могут затронуть не только как вы думаете о коде, но и как другие разработчики в вашей команде будут думать о нем. Думая неправильно о тщательно организованном асинхронном коде - это почти наверняка будет хуже, чем альтернативы из спагетти-колбеков.\n\nТак что на самом деле имеет значение, как вы их называете.\n\nСо вторым параметром легко определиться. Почти вся литература использует `reject(..)` (отвергнуть) как его имя и поскольку это в точности (и только это!) то, что он делает, это и есть очень хороший выбор для этого имени. Я бы настоятельно рекомендовал вам всегда использовать `reject(..)`.\n\nНо вокруг первого параметра чуть больше неясностей, который в литературе о промисах часто обозначается `resolve(..)` (разрешить). Это слово очевидно связано с \"resolution\" (разрешение), которое и используется во всей литературе (включая эту книгу), чтобы описать установку конечного значения/состояния в промисе. Мы уже использовать \"разрешить промис\" несколько раз, чтобы обозначить либо завершение, или отвергнутый промис.\n\nНо если этот параметр, по-видимому, используется для конкретно завершения промиса, почему бы не назвать его `fulfill(..)` (завершить) вместо `resolve(..)` (разрешить), чтобы быть более точным? Чтобы ответить на этот вопрос, давайте также взглянет на два метода `Promise` API:\n\n```js\nvar fulfilledPr = Promise.resolve( 42 );\n\nvar rejectedPr = Promise.reject( \"Ой\" );\n```\n\n`Promise.resolve(..)` создает промис, который разрешен со переданным значением. В этом примере, `42` - это обычное, не-промис, не-then-содержащее значение, поэтому завершенный промис `fulfilledPr` создан для значения `42`. `Promise.reject(\"Ой\")` создает отвергнутый промис `rejectedPr` для причины `\"Ой\"`.\n\nДавайте теперь проиллюстрируем, почему слово \"resolve\" (разрешить) (такое как в `Promise.resolve(..)`) - является однозначным и более точным, если используется явно в контексте, который должен либо завершиться, либо закончиться отказом:\n\n```js\nvar rejectedTh = {\n\tthen: function(resolved,rejected) {\n\t\trejected( \"Ой\" );\n\t}\n};\n\nvar rejectedPr = Promise.resolve( rejectedTh );\n```\n\nКак мы уже говорили ранее в этой главе, `Promise.resolve(..)` вернет полученный настоящий промис напрямую или распакует полученное then-содержащее. Если распаковка этого then-содержащего покажет отвергнутое состояние, то промис, который был возвращен из `Promise.resolve(..)` - по факту в том же самом отвергнутом состоянии.\n\nТаким образом `Promise.resolve(..)` - это хорошее, точное название для метода API, потому что он может либо завершиться, либо будет отвергнутым.\n\nПервый колбек-параметр конструктора `Promise(..)` распакует либо then-содержащее (идентично `Promise.resolve(..)`), либо настоящий промис:\n\n```js\nvar rejectedPr = new Promise( function(resolve,reject){\n\t// разрешить этот промис отвергнутым промисом\n\tresolve( Promise.reject( \"Ой\" ) );\n} );\n\nrejectedPr.then(\n\tfunction fulfilled(){\n\t\t// никогда не достигнет этой точки\n\t},\n\tfunction rejected(err){\n\t\tconsole.log( err );\t// \"Ой\"\n\t}\n);\n```\n\nТеперь должно быть ясно, что `resolve(..)` - подходящее название для для первого колбек-параметра конструктора `Promise(..)`.\n\n**Предупреждение:** Ранее упомянутый `reject(..)` **не** выполняет распаковку, как это делает `resolve(..)`. Если вы передадите промис или then-содержащее значение в `reject(..)`, то именно это значение нетронутым будет установлено как причина отказа. Последующий обработчик отказа получит настоящий промис/then-содержащее, которое вы передали в `reject(..)`, а не его внутреннее непосредственное значение.\n\nНо теперь давайте обратим наше внимание на колбеки, переданные в `then(..)`. Как их следует назвывать (и в литературе, и в коде)? Я бы предложил `fulfilled(..)` (завершенный) и `rejected(..)` (отвергнутый):\n\n```js\nfunction fulfilled(msg) {\n\tconsole.log( msg );\n}\n\nfunction rejected(err) {\n\tconsole.error( err );\n}\n\np.then(\n\tfulfilled,\n\trejected\n);\n```\n\nВ случае первого параметра в `then(..)` - это однозначно всегда случай завершения, поэтому нет нужны для двойственной терминологии \"resolve\". В качестве примечания, спецификация ES6 использует `onFulfilled(..)` и `onRejected(..)`, чтобы обозначить эти два колбека, поэтому они являются точными терминами.\n\n## Обработка ошибок\n\nМы уже видели несколько примеров того, как отказ промисов, либо намеренно через вызов `reject(..)`, либо случайно через исключение JS, позволяет более разумно обрабатывать ошибки при асинхронной разработке. Давайте вернемся назад и четко сформулируем некоторые детали, которые мы пропустили.\n\nСамая естественная форма обработки ошибок для большинства разработчиков - это синхронная конструкция `try..catch`. К сожалению, она есть только в синхронной форме, поэтому она не поможет в шаблонах асинхронного кода:\n\n```js\nfunction foo() {\n\tsetTimeout( function(){\n\t\tbaz.bar();\n\t}, 100 );\n}\n\ntry {\n\tfoo();\n\t// позднее выбросит глобальную ошибку из `baz.bar()`\n}\ncatch (err) {\n\t// никогда не достигнет этой точки\n}\n```\n\nБыло бы неплохо иметь в арсенале `try..catch`, но он не работает для асинхронных операций. То есть, если только нет какой-то дополнительной поддержки среды, к которой мы вернемся вместе с генераторами в главе 4.\n\nВ колбеках, появились некоторые стандарты для шаблонной обработки ошибок, особенно стиль \"колбек ошибки идет первым\":\n\n```js\nfunction foo(cb) {\n\tsetTimeout( function(){\n\t\ttry {\n\t\t\tvar x = baz.bar();\n\t\t\tcb( null, x ); // успех!\n\t\t}\n\t\tcatch (err) {\n\t\t\tcb( err );\n\t\t}\n\t}, 100 );\n}\n\nfoo( function(err,val){\n\tif (err) {\n\t\tconsole.error( err ); // облом :(\n\t}\n\telse {\n\t\tconsole.log( val );\n\t}\n} );\n```\n\n**Примечание** `try..catch` тут работает только с той точки зрения, что вызов `baz.bar()` немедленно завершится или прервется со сбоем и при этом синхронно. Если `baz.bar()` сам являлся своей же асинхронной функцией продолжения, то любые асинхронные ошибки внутри него нельзя будет поймать.\n\nКолбек, который мы передаем в `foo(..)`, ожидает получить сигнал об ошибке с помощью зарезервированного первого параметра `err`. Если присутствует, предполагается ошибка. Если нет, то предполагается завершение.\n\nТакой тип обработки ошибок технически *поддерживает асинхронность*, но он совсем не способен к композиции. Множественные уровни колбеков в стиле \"ошибка первая\" сплетенные вместе с этими вездесущими операторами проверок `if` неизбежно приведет вас к опасностям, связанным с адом колбеков (см. главу 2).\n\nТаким образом вы возвращаемся к обработке ошибок с помощью промисов, с передачей обработчика отказов в `then(..)`. Промисы не используют популярный стиль дизайна \"колбек с первым параметром-ошибкой\", а вместо этого используют стиль \"раздельных колбеков\", есть один колбек для завершения и другой - для отказа:\n\n```js\nvar p = Promise.reject( \"Ой\" );\n\np.then(\n\tfunction fulfilled(){\n\t\t// никогда не достигнет этой точки\n\t},\n\tfunction rejected(err){\n\t\tconsole.log( err ); // \"Ой\"\n\t}\n);\n```\n\nНесмотря на то, что этот шаблон обработки ошибок, на первый взгляд, имеет смысл, нюансы обработки ошибок в промисах зачастую гораздо сложнее полностью осознать.\n\nПредставьте:\n\n```js\nvar p = Promise.resolve( 42 );\n\np.then(\n\tfunction fulfilled(msg){\n\t\t// числа не содержат функцией как у строк,\n\t\t// поэтому тут возникнет ошибка\n\t\tconsole.log( msg.toLowerCase() );\n\t},\n\tfunction rejected(err){\n\t\t// никогда не достигнет этой точки\n\t}\n);\n```\n\nЕсли `msg.toLowerCase()` законно выдает ошибку (и это действительно так!), почему же наш обработчик ошибок не вызван? Как мы объясняли ранее, так происходит потому, что *этот* обработчик ошибок - для промиса `p`, который уже был разрешен со значением `42`. Промис `p` - неизменяемый, поэтому единственный промис, который может получить ошибку, тот, что возвращается из `p.then(..)`, который мы в этом случае никак не ловим.\n\nЭто должно дать четкое представление о том, почему обработка ошибок в промисах подвержена ошибкам (каламбур). Слишком легко допустить, чтобы ошибки были \"проглочены\", так как это очень редко то, что вы задумывали изначально.\n\n**Предупреждение:** Если вы используете API промисов неправильным путем и происходит ошибка, то это препятсвует правильному созданию промиса, в результате будет полученное сращу же исключение, но **не отвергнутый промис**. Некоторые примеры некорректного использования, который ломают создание промиса: `new Promise(null)`, `Promise.all()`, `Promise.race(42)`, и т.д.. Вы не сможете получить отвергнутый промис, если вы не используете API промисов достаточно корректно, чтобы на само деле создать в первую очередь сам промис!\n\n### Яма отчаяния\n\nДжефф Этвуд заметил несколько лет назад: языки программирования часто настроены настоены по умолчанию таким образом, что разработчки попадают в \"яму отчаяния\" (http://blog.codinghorror.com/falling-into-the-pit-of-success/), где за инциденты наказывают и что нужно больше стараться, чтобы все получилось. Он призвал нас вместо этого создавать \"яму успеха,\" когда по умолчанию вы попадаете в ожидаемое (успешное) действие, и, следовательно, должны сильно постараться, чтобы потерпеть неудачу.\n\nОбработка ошибок в промисах - несомненно, является дизайном \"ямы отчаяния\". По умолчанию, он предполагает, что вы хотите, чтобы любые ошибки были поглощены состоянием промиса и если вы забудете исследовать этот состояние, ошибка тихо томится/умирает в безвестности, обычно отчаяния.\n\nЧтобы избежать ошибки из-за молчания забытого/заброшенного промиса, некоторые разработчики заявили, что \"лучшей практикой\" для цепочек промисов является всегда завершать цепочку заключительным `catch(..)`, например:\n\n```js\nvar p = Promise.resolve( 42 );\n\np.then(\n\tfunction fulfilled(msg){\n\t\t// числа не содержат функцией как у строк,\n\t\t// поэтому тут возникнет ошибка\n\t\tconsole.log( msg.toLowerCase() );\n\t}\n)\n.catch( handleErrors );\n```\n\nПоскольку мы не передали обработчик отказов в `then(..)`, был подставлен обработчик по умолчанию, который просто передает ошибку следующему промису в цепочке. Таким образом, обе ошибки, идущие в `p`, и ошибки, которые появляются *после* `p` в его разрешении (как в `msg.toLowerCase()`) будут отфильтрованы до конечного `handleErrors(..)`.\n\nПроблема решена, не так ли? Не так быстро!\n\nЧто случится, если `handleErrors(..)` сам содержит ошибку? Кто отловит ее? Остался еще один невыполненный промис: тот, который возвращает `catch(..)`, который мы не ловим и не регистрируем обработчик отказа для него.\n\nВы не можете просто приклеить другой `catch(..)` в конец этой цепочки, потому что он тоже может завершиться ошибкой. Последний шаг в любой цепочек промисов, какой бы он ни был, всегда будет содержать возможность, хоть и в меньшей степени, зависнуть с непойманной ошибкой, застрявшей внутри неотслеживаемого промиса.\n\nВсе еще звучит как невыполнимая головоломка?\n\n### Обработка непойманного\n\nЭту проблему нелегко решить полностью. Есть и другие способы достичь этого, которые, по мнению многих, являются *лучшими*.\n\nНекоторые промис-библиотеки добавили методы для регистрации чего-то подобного \"глобальному обработчику необработанных отказов\", который бы вызывался вместо глобального выброса ошибки. Но их решение о том, как определить ошибку как \"непойманную\" - это иметь таймер произвольной длительности, скажем 3 секунды, запускаемый от момента отказа. Если промис отвергнут, но не было зарегистрировано ни одного обработчика ошибок до того, как будет запушен таймер, то предполагается, что вы будто и не регистрировали ни одного обработчика, поэтому ошибка \"не поймана\".\n\nНа практике, это хорошо работает для многих библиотек, поскольку большинство использованных подходов как правило не требуют значительной задержки между отказом промиса и началом наблюдения за ним. Но этот шаблон вызывает проблемы, потому что 3 секунды это очень произвольное время (пусть даже эмпирическое), а также потому, что действительно есть случаи когда вы хотите придержать отказ промиса на некоторый неопределенный период времени и вы на самом деле не хотите, чтобы ваш обработчик \"непойманного\" вызывался для всех этих ложных срабатываний (еще не обработанные \"непойманные ошибки\").\n\nДругое более распространенное предложение заключается в том, что к промисам нужно добавить `done(..)`, что, по сути, отмечает цепочку промисов как \"выполненную\" (done). `done(..)` не создает и не возвращает промис, таким образом колбеки, переданные в `done(..)`, очевидно не подключены для извещения о проблемах в промис в цепочке, который не существует.\n\nИтак, что происходит вместо этого? Она обрабатывается так, как вы обычно ожидаете в условиях не пойманной ошибки: любое исключение внутри обработчика отказа `done(..)` будет выброшено как глобальная непойманная ошибка (в консоль разработчика, по сути):\n\n```js\nvar p = Promise.resolve( 42 );\n\np.then(\n\tfunction fulfilled(msg){\n\t\t// у чисел нет функций как у строк,\n\t\t// поэтому будет выброшена ошибка\n\t\tconsole.log( msg.toLowerCase() );\n\t}\n)\n.done( null, handleErrors );\n\n// если `handleErrors(..)` породила свое собственное исключение, оно\n// будет выброшено тут как глобальное\n```\n\nЭто может показаться более привлекательным, чем бесконечная цепочка или произвольные тайм-ауты. Но самая большая проблема заключается в том, что это не является частью стандарта ES6, поэтому, как бы хорошо это ни звучало, в лучшем случае это еще долго не будет надежным и повсеместным решением.\n\nНеужели мы просто застряли? Не совсем.\n\nБраузеры имеют уникальную возможность, которой нет у нашего кода: они могут отслеживать и точно знать, когда любой объект становится ненужным и собирается сборщиком мусора. Таким образом, браузеры могут отслеживать объекты промисов и всякий раз, когда их собирает сборщик мусора, если они содержат отказ, браузер точно знает, что это была допустимая \"непойманная ошибка\", и поэтому может с уверенностью утверждать, что должен сообщить о ней в консоль разработчика.\n\n**Примечание** На момент написания этой статьи, в обоих Chrome и Firefox есть ранние ранние попытки такого рода возможности \"непойманный отказ\", хотя поддержка в лучшем случае неполная.\n\nОднако, если промис не был собран сборщиком мусора, что очень легко сделать случайно с помощью множества различных шаблонов разработки, осведомленность сборщика мусора браузера не поможет вам узнать и диагностировать, что у вас есть молча отвергнутый промис, находящийся рядом.\n\nЕсть ли другие альтернативы? Да.\n\n### Яма успеха\n\nНижеследующее является лишь теоретическим, как промисы *могли бы* однажды изменить свое поведение. Я верю, что Я уверен, что это будет намного лучше, чем то, что мы имеем сейчас. И я думаю, что это изменение будет возможно даже в пост-ES6, потому что я не думаю, что это нарушит совместимость с ES6 промисами. Более того, это можно превратить в полифил, если вы будете осторожны. Давайте взглянем:\n\n* Промисы могут по умолчанию сообщать (в консоль разработчика) о любом отказе в следующей задаче или тике цикла событий, если в этот момент для промиса не был зарегистрирован обработчик ошибок.\n* Для случаев, когда вы хотите удерживать отвергнутый промис в таком состоянии на бесконечное количество времени до начала наблюдения за ним, вы могли бы вызвать `defer()`, который подавляет автоматическое уведомление об ошибках в этом промисе.\n\nЕсли промис отвергнут, по умолчанию он шумно сообщает об этом факте в консоль разработчика (вместо тишины по умолчанию). Вы можете отказаться от такой информации, либо неявно (зарегистрировав обработчик ошибок до отказа), или явно (с помощью `defer()`). В любом случае, *вы* управляете ложными срабатываниями.\n\nРассмотрим:\n\n```js\nvar p = Promise.reject( \"Ой\" ).defer();\n\n// `foo(..)` промисоподобная\nfoo( 42 )\n.then(\n\tfunction fulfilled(){\n\t\treturn p;\n\t},\n\tfunction rejected(err){\n\t\t// обработка ошибок в `foo(..)`\n\t}\n);\n...\n```\n\nКогда мы создаем `p`, мы знаем, что мы собираемся подождать некоторое время, чтобы использовать/наблюдать за его отказом, поэтому мы вызываем `defer()` - таким образом, отсутствует глобальная отчетность. `defer()` просто возвращает тот же промис для возможности выстраивания цепочки.\n\nПромис, возвращенный из `foo(..)`, получает обработчик ошибок, привязанный *сразу же*, поэтому она выходит \"из игры\" и никакой глобальной отчетности по этому поводу также не ведется.\n\nА вот у промиса, возвращенного из вызова `then(..)`, нет ни `defer()`, ни присоединенного обработчика ошибок, поэтому если он завершается отказом (изнутри любого обработчика разрешения), то *он* будет сообщен в консоль разработчика как не пойманная ошибка.\n\n**\"Этот подход\" - яма успеха.** По умолчанию, все ошибки либо обрабатываются, либо о них получаются уведомления, то, что почти все разработчики в почти всех случаях ожидали бы. Вы либо должны зарегистрировать обработчик, либо вы должны намеренно отказаться и указать, что вы намерены отложить обработку ошибок на *попозже*, вы берете дополнительную ответственность только в этом конкретном случае.\n\nЕдинственная реальная опасность в этом подходе - если вы отложите (`defer()`) промис, а затем не сможете на деле вообще наблюдать/обработать его отказ.\n\nНо вы должны были намеренно вызвать `defer()`, чтобы опуститься в эту яму отчаяния, изначально была яма успеха, поэтому мы мало что можем сделать, чтобы спасти вас от ваших собственных ошибок.\n\nЯ думаю, что все еще есть надежда на обработку ошибок промисов (пост-ES6). Я надеюсь, что власть предержащие переосмыслят ситуацию и рассмотрят эту альтернативу. Тем временем, вы можете реализовать это сами (непростое упражнение для читателя!) или использовать *более умную* библиотеку промисов, которая сделает это за вас!\n\n**Примечание** Эта конкретная модель обработки ошибок/сообщений реализована в моей библиотеке абстракций над промисами *asynquence*, которую обсудим в приложении A этой книги.\n\n## Шаблоны промисов\n\nМы уже увидено неявно шаблон последовательности в цепочках промисов (управление потоком это-затем-это-затем-то), но существует множество вариаций асинхронных шаблонов, которые мы можем построить как абстракции над промисами. Этим шаблоны служат для упрощения выражения асинхронного управления потоком, который помогает сделать наш код более более разумным и более поддерживаемым, даже в самых сложных частях наших программ.\n\nДва таких шаблона кодируются непосредственно в нативную реализацию ES6 `Promise`, так что мы получаем их бесплатно, чтобы использовать как строительные блоки для других шаблонов.\n\n### Promise.all([ .. ])\n\nВ асинхронной последовательности (цепочке промисов) только одна асинхронная задача координируется в любой момент времени, шаг 2 строго следует за шагом 1, а шаг 3 строго следует за шагом 2. А как насчет выполнения двух и более шагов одновременно (т.е. \"параллельно\")?\n\nВ классической терминологии программирования, \"шлюз\" - это механизм, который ожидает завершения двух или более параллельных/ одновременных задач, прежде чем продолжить работу. Не важно в каком порядке они завершатся, а важно только, что все они должны завершиться чтобы открыть шлюз и позволить потоку управлению потоком идти дальше.\n\nВ API промисов, мы называем этот шаблон `all([ .. ])`.\n\nСкажем вы хотели сделать два Ajax-запроса в одно и то же время и дождаться окончания обоих, независимо от их порядка, до выполнения третьего Ajax-запроса. Рассмотрим:\n\n```js\n// `request(..)` - промис-совместимая Ajax-функция,\n// примерно как та, что мы определяли ранее в главе\n\nvar p1 = request( \"http://some.url.1/\" );\nvar p2 = request( \"http://some.url.2/\" );\n\nPromise.all( [p1,p2] )\n.then( function(msgs){\n\t// оба `p1` and `p2` завершатся успешно и передадут\n\t// свои сообщения сюда\n\treturn request(\n\t\t\"http://some.url.3/?v=\" + msgs.join(\",\")\n\t);\n} )\n.then( function(msg){\n\tconsole.log( msg );\n} );\n```\n\n`Promise.all([ .. ])` ожидает один аргумент, `массив`, состоящий состоящий в целом из экземпляров промисов. Промис, возвращенный из вызова `Promise.all([ .. ])`, получит сообщение о завершении (`msgs` в этом примере кода), которое является `массивом` всех сообщений о завершении от переданных промисов, в том же порядке как они были переданы (независимо от порядка завершения).\n\n**Примечание** Технически, `массив` значений, переданный в `Promise.all([ .. ])`, может содержать промисы, then-содержащие или даже непосредственные значения. Каждое значение в списке по сути, проходит через `Promise.resolve(..)`, чтобы убедиться, что ожидается настоящий промис, таким образом непосредственное значение будет просто приведено в промис для этого значения. Если `массив` пустой, основной промис немедленно завершается.\n\nОсновной промис, возвращенный из `Promise.all([ .. ])`, будет завершен только тогда и если все входящие в него промисы будут завершены. Если любой из этих промисов вместо этого отвергается, основной промис `Promise.all([ .. ])` сразу же отвергается, отбрасывая все результаты любых других промисов.\n\nПомните о том, чтобы всегда присоединять обработчик отказа/ошибки к каждому промису, даже и особенно к тому, который возвращается из `Promise.all([ .. ])`.\n\n### Promise.race([ .. ])\n\nВ то время как `Promise.all([ .. ])` координирует несколько обещаний одновременно и предполагает, что все они нужны для завершения, иногда вы хотите всего лишь получить ответ от \"первого же промиса, пересекшего финишную линию\", позволяя других промисам отпасть за ненадобностью.\n\nЭтот шаблон классически называют \"задвижка\" (latch), но в промисах он называется \"гонка\" (race).\n\n**Предупреждение:** В то время как метафора \"только первый, пересёкший финишную черту, выигрывает\" хорошо соответствует поведению, к сожалению \"гонка\" - это своего рода нагруженный термин, потому что \"состояния гонки\" - обычно воспринимаются как ошибки в программах (см. главу 1). Не путайте `Promise.race([ .. ])` с \"состоянием гонки\" (race condition).\n\n`Promise.race([ .. ])` также ожидает единственный аргумент в виде `массива`, содержащий один или более промисов, then-содержащих или непосредственных значений. Не имеет большого практического смысла иметь гонку с непосредственными значениями, потому что первое перечисленное значение очевидно выиграет, как в беге, где один бегун стартует с финиша!\n\nАналогично `Promise.all([ .. ])`, `Promise.race([ .. ])` завершится если и тогда, когда любое из разрешений промисов - успешное, и завершится отказом если и тогда, когда любое из разрешений промисов - это отказ.\n\n**Предупреждение:** \"гонка\" требует по меньшей мере одного \"бегуна\", поэтому если вы передадите пустой `массив`, вместо немедленно разрешения, основной промис `race([..])` никогда не будет разрешен. Это программные \"грабли\"! ES6 должен был указать, что он либо выполняет, либо отклоняет, либо просто выбрасывает какую-то синхронную ошибку. К сожалению, из-за прецедента в библиотеках промисов, предшествующих ES6 `Promise`, им пришлось оставить эту недоработку, поэтому будьте осторожны и никогда не отправляйте пустой `массив`.\n\nДавайте вернемся к нашему предыдущему примеру с параллельным Ajax, но в контексте гонки между `p1` и `p2`:\n\n```js\n// `request(..)` - это промис-совместимая функция,\n// подобно той, что мы ранее определили в этой главе\n\nvar p1 = request( \"http://some.url.1/\" );\nvar p2 = request( \"http://some.url.2/\" );\n\nPromise.race( [p1,p2] )\n.then( function(msg){\n\t// либо `p1`, либо `p2` выиграет гонку\n\treturn request(\n\t\t\"http://some.url.3/?v=\" + msg\n\t);\n} )\n.then( function(msg){\n\tconsole.log( msg );\n} );\n```\n\nПоскольку побеждает только один промис, значение завершения - это одно сообщение, а не `массив`, как это было в `Promise.all([ .. ])`.\n\n#### Гонка тайм-аутов\n\nМы видели этот пример ранее, иллюстрирующий как `Promise.race([ .. ])` может использоваться для выражения шаблона \"тайм-аут промиса\":\n\n```js\n// `foo()` - функция, поддерживающая промисы\n\n// `timeoutPromise(..)`, определенный ранее, аозвращает\n// промис, который завершается отказом rejects после указанной задержки\n\n// настроить тайм-аут для `foo()`\nPromise.race( [\n\tfoo(),\t\t\t\t\t// попробовать вызвать `foo()`\n\ttimeoutPromise( 3000 )\t// дать ему 3 секунды\n] )\n.then(\n\tfunction(){\n\t\t// `foo(..)` завершилась успешно и вовремя!\n\t},\n\tfunction(err){\n\t\t// либо `foo()` завершился отказом, либо просто\n\t\t// не успеет завершиться вовремя, поэтому загляните в\n\t\t// `err`, чтобы узнать причину\n\t}\n);\n```\n\nЭтот шаблон тайм-аута работает в большинстве случаев. Но есть некоторые нюансы, которые необходимо учитывать, и, честно говоря, они применимы к обоим `Promise.race([ .. ])` и `Promise.all([ .. ])` в равной степени.\n\n#### \"Finally\"\n\nКлючевой вопрос, который необходимо задать: \"Что происходит с промисами, который который отбрасываются/игнорируются?\" Мы задаем этот вопрос не с точки зрения производительности, они, как правило, попадают в сборку мусора как подходящие кандидаты для этого, а с поведенческий аспекта (побочные эффекты и т.д.). Промисы нельзя отменить, и не должны бы, поскольку это разрушит доверие к внешней неизменяемости, обсуждаемой в секции \"Промис неотменяемый\" позже в этой главе, поэтому их можно только молча игнорировать.\n\nНо что если `foo()` из предыдущего примера резервирует какой-то ресурс для использования, но первым срабатывает тайм-аут и приводит к тому, что этот промис игнорируется? Есть ли в этом шаблоне что-нибудь, что с упреждением освобождает зарезервированный ресурс после истечения тайм-аута или иным образом отменяет любые побочные эффекты, которые он мог иметь? Что если всё, что вы хотели - это зафиксировать факт того, что `foo()` завершился по тайм-ауту?\n\nНекоторые разработчики предлагают, что промису нужна регистрация колбека `finally(..)`, который вызывается всегда, когда промис разрешен, и позволяет вам и позволяет вам указать любую очистку, которая может потребоваться. На текущий момент такого нет в спецификации, но может появиться в ES7+. Подождем и посмотрим.\n\nЭто может выглядеть так:\n\n```js\nvar p = Promise.resolve( 42 );\n\np.then( something )\n.finally( cleanup )\n.then( another )\n.finally( cleanup );\n```\n\n**Примечание** В различных промис-библиотеках `finally(..)` все еще создает и возвращает новый промис (чтобы продолжать цепочку). Если бы функция `cleanup(..)` возвращала промис, его можно было бы соединить в цепочку, что означает, что у вас все еще могли бы быть проблемы с неразрешенными отказами, которые мы ранее обсуждали.\n\nТем временем, мы могли бы создать статическую вспомогательную функцию, которая позволит нам наблюдать (без вмешательства) за разрешением промиса:\n\n```js\n// защитная проверка в стиле безопасного полифила\nif (!Promise.observe) {\n\tPromise.observe = function(pr,cb) {\n\t\t// стороннее наблюдение за разрешением `pr`\n\t\tpr.then(\n\t\t\tfunction fulfilled(msg){\n\t\t\t\t// запланировать колбек асинхронно (в виде задачи)\n\t\t\t\tPromise.resolve( msg ).then( cb );\n\t\t\t},\n\t\t\tfunction rejected(err){\n\t\t\t\t// запланировать колбек асинхронно (в виде задачи)\n\t\t\t\tPromise.resolve( err ).then( cb );\n\t\t\t}\n\t\t);\n\n\t\t// вернуть оригинальный промис\n\t\treturn pr;\n\t};\n}\n```\n\nВот как мы используем его в предыдущем примере с тайм-аутом:\n\n```js\nPromise.race( [\n\tPromise.observe(\n\t\tfoo(),\t\t\t\t\t// попытка вызова `foo()`\n\t\tfunction cleanup(msg){\n\t\t\t// почистить за `foo()`, даже если она\n\t\t\t// не завершилась после тайм-аута\n\t\t}\n\t),\n\ttimeoutPromise( 3000 )\t// дать функции тайм-аут в 3 секунды\n] )\n```\n\nЭто вспомогательная функция `Promise.observe(..)` - просто иллюстрация того, как вы могли бы наблюдать за завершениями промисов без вмешательства в них. В других библиотеках промисов есть свои собственные решения. Независимо от того, как вы это сделаете, скорее всего, у вас будут места, где вы захотите убедиться, что ваши промисы не будут *просто* молча проигнорированы случайно.\n\n### Вариации на тему all([ .. ]) и race([ .. ])\n\nВ то время как нативные ES6 промисы идут со встроенными `Promise.all([ .. ])` и `Promise.race([ .. ])`, есть несколько других часто используемых паттернов с вариациями этой семантики:\n\n* `none([ .. ])` похож на `all([ .. ])`, но завершения и отказы меняются местами. Все промисы должны быть отвергнуты, отказы становятся значениями завершения, а значения завершения - наоборот.\n* `any([ .. ])` похож на `all([ .. ])`, но она игнорирует любые отказы, поэтому нужно выполнить только один, а не *все*.\n* `first([ .. ])` похож на гонку в сочетании с `any([ .. ])`, которая заключается в том, что она игнорирует любые отказы и завершается, как только завершается первый промис.\n* `last([ .. ])` похож на `first([ .. ])`, но только побеждает самое последнее завершение.\n\nНекоторые библиотеки абстракций над промисами обеспечивают такие функции, но вы также можете определить из сами использую механизмы промисов, `race([ .. ])` и `all([ .. ])`.\n\nНапример, вот как мы могли бы определить `first([ .. ])`:\n\n```js\n// защитная проверка в стиле безопасного полифила\nif (!Promise.first) {\n\tPromise.first = function(prs) {\n\t\treturn new Promise( function(resolve,reject){\n\t\t\t// цикл по всем промисам\n\t\t\tprs.forEach( function(pr){\n\t\t\t\t// нормализовать значение\n\t\t\t\tPromise.resolve( pr )\n\t\t\t\t// кто завершится первым, тот и победил, и\n\t\t\t\t// приводит к разрешению основного промиса\n\t\t\t\t.then( resolve );\n\t\t\t} );\n\t\t} );\n\t};\n}\n```\n\n**Примечание** Такая реализация `first(..)` не завершается отказом если все ее промисы завершаются отказом; она просто зависает, подобно тому, как работает `Promise.race([])`. При необходимости, вы могли бы добавить дополнительную логику для отслеживания каждого отказа промисов и если все они отвергнуты, вызвать `reject()` для основного промиса. Оставим это как упражнение для читателя.\n\n### Одновременные итерации\n\nИногда вы хотите проходить по списку промисов и выполнить некоторую задачу для них всех, так же, как это можно сделать с синхронными `array`s (например, `forEach(..)`, `map(..)`, `some(..)`, and `every(..)`). Если задача, которую нужно выполнить по отношению к каждому промису, является принципиально синхронной, это отлично работает, точно так же, как мы использовали `forEach(..)` в предыдущем отрывке кода.\n\nНо если задачи принципиально асинхронные или могут/должны в противном случае выполняться одновременно, вы можете воспользоваться асинхронными версиями этих функций, предоставляемых многими библиотеками.\n\nНапример, давайте рассмотрим асинхронную функцию `map(..)`, которая принимает `массив` значений (могут быть промисами или чем-то еще), плюс функцию (задачу), для выполнения над каждым значением. `map(..)` сам по себе возвращает промис, чье значение завершения - `массив`, который хранит (в том же порядке) асинхронное значение завершения из каждой задачи:\n\n```js\nif (!Promise.map) {\n\tPromise.map = function(vals,cb) {\n\t\t// новый промис, который ждет все сопоставленные промисы\n\t\treturn Promise.all(\n\t\t\t// примечание: обычная функция массива `map(..)`, превращает\n\t\t\t// массив значений в массив промисов\n\t\t\tvals.map( function(val){\n\t\t\t\t// заменить `val` новым промисом, который\n\t\t\t\t// разрешается после того, как `val` асинхронно отмаплена\n\t\t\t\treturn new Promise( function(resolve){\n\t\t\t\t\tcb( val, resolve );\n\t\t\t\t} );\n\t\t\t} )\n\t\t);\n\t};\n}\n```\n\n**Примечание** В этой реализации `map(..)` вы не можете сигнализировать об асинхронном отказе, но если происходит синхронное исключение/ошибка внутри колбека маппинга (`cb(..)`), основной промис, возвращающийся из the main `Promise.map(..)` будет отвергнут.\n\nДавайте проиллюстрируем использование `map(..)` со списком промисов (вместо простых значений):\n\n```js\nvar p1 = Promise.resolve( 21 );\nvar p2 = Promise.resolve( 42 );\nvar p3 = Promise.reject( \"Ой\" );\n\n// удвоить значения в списке, даже если они в промисах\nPromise.map( [p1,p2,p3], function(pr,done){\n\t// убедиться, что само значение - это промис\n\tPromise.resolve( pr )\n\t.then(\n\t\t// извлечь значение как `v`\n\t\tfunction(v){\n\t\t\t// отмапить значение завершения `v` в новое значение\n\t\t\tdone( v * 2 );\n\t\t},\n\t\t// или отмапить в сообщение отказа промиса\n\t\tdone\n\t);\n} )\n.then( function(vals){\n\tconsole.log( vals );\t// [42,84,\"Ой\"]\n} );\n```\n\n## Обзор API промисов\n\nДавайте проведем обзор ES6 `Promise` API, которые мы уже в какой-то степени наблюдали в этой главе.\n\n**Примечание** Следующий API является нативным только в ES6, но есть полифилы, совместимые со спецификацией (а не просто расширенные библиотеки промисов), которые могут определить `Promise` и все связанное с ним поведение, так что вы можете использовать нативные промисы даже в до-ES6 браузерах. Один такой полифил - это \"Native Promise Only\" (http://github.com/getify/native-promise-only), который написал я!\n\n### Конструктор new Promise(..)\n\n*Доступный конструктор* `Promise(..)` должен использоваться с `new` и в него нужно передать колбек-функцию, которая вызывается синхронно/немедленно. Это функция передается в в два колбека, которые действуют как возможности для разрешения промиса. Мы обычно называем их `resolve(..)` и `reject(..)`:\n\n```js\nvar p = new Promise( function(resolve,reject){\n\t// `resolve(..)` чтобы разрешить/завершить промис\n\t// `reject(..)` чтобы отвергнуть промис\n} );\n```\n\n`reject(..)` просто отвергает промис, а `resolve(..)` может либо завершить промис или отвергнуть его, в зависимости от того, что передано на вход. Если в `resolve(..)` передано непосредственное, не-промис, не-then-содержащее значение, то промис завершается с этим значением.\n\nНо если в `resolve(..)` передается настоящий промис или then-содержащее значение, то это значение будет рекурсивно распаковано, и какое бы ни было его окончательное разрешение/состояние - оно будет принято промисом.\n\n### Promise.resolve(..) и Promise.reject(..)\n\nКраткий вариант для создания уже отвергнутого промиса - `Promise.reject(..)`, таким образом эти два промиса равнозначны:\n\n```js\nvar p1 = new Promise( function(resolve,reject){\n\treject( \"Ой\" );\n} );\n\nvar p2 = Promise.reject( \"Ой\" );\n```\n\n`Promise.resolve(..)` обычно используется для создания уже завершенного промиса примерно также как `Promise.reject(..)`. Однако, `Promise.resolve(..)` также распаковывает then-содержащие значения (как уже неоднократно обсуждалось). В этом случае, возвращенный промис принимает окончательное разрешение then-содержащего, которое вы передали, которое может быть либо завершением, либо отказом:\n\n```js\nvar fulfilledTh = {\n\tthen: function(cb) { cb( 42 ); }\n};\nvar rejectedTh = {\n\tthen: function(cb,errCb) {\n\t\terrCb( \"Ой\" );\n\t}\n};\n\nvar p1 = Promise.resolve( fulfilledTh );\nvar p2 = Promise.resolve( rejectedTh );\n\n// `p1` станет завершенным промисом\n// `p2` станет отвергнутым промисом\n```\n\nИ помните, `Promise.resolve(..)` ничего не дает, если то, что вы передаете ему, является настоящим промисом, она просто непосредственно вернет это значение. Поэтому нет никаких затрат на вызов `Promise.resolve(..)` со значениями чью природу вы не знаете, если они уже оказались настоящими промисами.\n\n### then(..) и catch(..)\n\nКаждый экземпляр промиса (но **не** пространства имен `Promise` API) содержит методы `then(..)` и `catch(..)`, которые позволяют зарегистрировать обработчики завершения и отказа для этого промиса. Как только промис разрешен, будет вызван один из этих обработчиков, но не оба, и он всегда будет вызваться асинхронно (см. \"Задачи\" в главе 1).\n\n`then(..)` принимает один или два параметра, первый - для колбека завершения, а второй - для колбека отказа. Если какой-либо из параметров будет опущен или будет передано значение не-функция, то подставляется колбек по умолчанию соответственно. Колбек завершения по умолчанию просто передает сообщение дальше, в то время как колбек отказа по умолчанию просто заново выбрасывает (распространяет дальше) полученную причину ошибки (propagates).\n\n`catch(..)` принимает только колбека отказа как параметр и автоматически подставляет обработчик завершения по умолчанию, как только что упоминалось. Другими словами, это - эквивалент `then(null,..)`:\n\n```js\np.then( fulfilled );\n\np.then( fulfilled, rejected );\n\np.catch( rejected ); // или `p.then( null, rejected )`\n```\n\n`then(..)` и `catch(..)` также создают и возвращают новый промис, который можно использовать для выражения управления потоком цепочки промисов. Если у колбеков завершения или отказа уже есть выброшенное исключение, то возвращаемый промис будет отвергнут. Если какой-либо из колбеков вернет непосредственное, не-промис, не-then-содержащее значение, то это значение будет установлено как завершение возвращенного промиса. Если обработчик завершения специально возвращает промис или then-содержащее значение, то это значение распаковывается и становится разрешением возвращенного промиса.\n\n### Promise.all([ .. ]) и Promise.race([ .. ])\n\nСтатические вспомогательные функции `Promise.all([ .. ])` и `Promise.race([ .. ])` в ES6 `Promise` API обе создают промис как свое возвращаемое значение. Разрешение этого промиса целиком управляется массивом промисов, который вы передаете на вход.\n\nДля `Promise.all([ .. ])` все промисы, которые вы передаете, должны завершиться, чтобы возвращаемый промис также завершился. Если какой-либо из промисов будет отвергнут, главный возвращаемый промис будет также немедленно отвергнут (отбрасывая результаты любых других промисов). При завершении вы получаете `массив` всех переданных в промисы значений завершения. При отказе, вы получаете только значение причины отказа первого промиса. Этот шаблон классически называется \"шлюз (gate)\": все должны прибыть до того, как откроется шлюз.\n\nДля `Promise.race([ .. ])`, только первый промис с разрешением (завершение или отказ) \"выигрывает\", и какое бы ни было его разрешение, оно и становится разрешением возвращаемого промиса. Этот шаблон классически называется \"задвижка (latch)\": первый, кто откроет задвижку - проходит. Представьте:\n\n```js\nvar p1 = Promise.resolve( 42 );\nvar p2 = Promise.resolve( \"Привет, мир\" );\nvar p3 = Promise.reject( \"Ой\" );\n\nPromise.race( [p1,p2,p3] )\n.then( function(msg){\n\tconsole.log( msg );\t\t// 42\n} );\n\nPromise.all( [p1,p2,p3] )\n.catch( function(err){\n\tconsole.error( err );\t// \"Ой\"\n} );\n\nPromise.all( [p1,p2] )\n.then( function(msgs){\n\tconsole.log( msgs );\t// [42,\"Привет, мир\"]\n} );\n```\n\n**Предупреждение:** Будьте осторожны! Если в `Promise.all([ .. ])` будет передает пустой массив, то функция завершится немедленно, а вот `Promise.race([ .. ])` повиснет навсегда и никогда не разрешится.\n\nES6 `Promise` API довольно простое и понятное. Оно, по крайней мере, достаточно хорош, чтобы обслуживать самые простые случаи асинхронной работы и это хорошее место для начала перестройки вашего кода из ада колбеков в нечто лучшее.\n\nНо существует целый ряд асинхронных сложностей, которые часто требуются приложениям и для которых промисы сами по себе будут ограничены в решении. В следующем разделе мы погрузимся в эти ограничения как мотивацию для создания библиотек промисов.\n\n## Ограничения промисов\n\nМногие детали, которые мы обсудим в этом разделе, уже упоминались в этой главе, но мы просто рассмотрим эти ограничения отдельно.\n\n### Обработка ошибок последовательностей\n\nМы подробно рассмотрели обработку ошибок с помощью промисов в начале этой главы. Ограничения в том, как разработаны промисы, в частности, как они связываются в цепочки, создают очень легкую ловушку, когда ошибка в цепочке промисов может быть молча проигнорирована случайно.\n\nНо есть еще кое-что, что следует учитывать с ошибками промисов. Поскольку цепочка промисов - это не что иное, как входящие в нее промисы, соединенные вместе, нет никакой сущности, чтобы ссылаться на всю цепочку как на единое *нечто*, что означает, что нет внешнего способа наблюдения за возможными ошибками.\n\nЕсли вы конструируете цепочку промисов, в которой нет обработки ошибок, любая ошибка где бы то ни было в цепочке будет распространяться бесконечно вниз по цепочке, пока не будет замечена (регистрацией обработчика отказов на каком-либо шаге). Так что, в этом конкретном случае, иметь ссылку на *последний* промис в цепочке будет достаточно (`p` в последующем примере кода), потому что вы можете зарегистрировать там обработчик отказов, и он будет уведомлен о любых распространяемых ошибках:\n\n```js\n// `foo(..)`, `STEP2(..)` и `STEP3(..)` -\n// обе функции поддерживают промисы\n\nvar p = foo( 42 )\n.then( STEP2 )\n.then( STEP3 );\n```\n\nХотя это может показаться хитрым и запутанным, `p` здесь не указывает на первый промис в цепочке (тот, что получен из вызова `foo(42)`), а вместо этого из последнего промиса, того, который возвращается из вызова `then(STEP3)`.\n\nКроме того, ни один шаг в цепочке промисов не выполняет собственную обработку ошибок. Это означает, что вы могли бы зарегистрировать обработчик ошибок отказа для `p` и он получит уведомление если возникнет какая-нибудь ошибка в цепочке:\n\n```\np.catch( handleErrors );\n```\n\nНо если любой этап цепочки фактически выполняет собственную обработку ошибок (возможно скрыто/абстрагировано от того, что вы можете увидеть), ваш `handleErrors(..)` не получит уведомлений. Возможно это и будет то, что вы хотите, это же был, в конце концов, \"обработанный отказ\", но это также может и *не* быть тем, что вы хотели. Полное отсутствие возможности получать уведомления (об \"уже обработанных\" ошибках отказа) является ограничением, которое сужает возможности в некоторых сценариях использования.\n\nПо сути, это то же самое ограничение, которое существует для блока `try..catch`, который может поймать исключение и просто проглотить его. Таким образом, это не является ограничением **специфичным для промисов**, но это *то*, для чего мы могли бы захотеть наличия обходного пути.\n\nК сожалению, во многих случаях не сохраняются ссылки на промежуточные шаги в последовательности цепочки промисов, поэтому без таких ссылок вы не сможете подключить обработчики ошибок для надежного наблюдения за ошибками.\n\n### Единственное значение\n\nУ промисов по определению есть только одно значение завершения или одна причина отказа. В простых примерах, это не так уж и важно, но в более сложных сценариях вы можете счесть это ограничением.\n\nТипичный совет - создать обертку для значений (такую как `объект` или `массив`), чтобы хранить эти многочисленные сообщения. Это решение работает, но это может быть довольно неудобно и утомительно - упаковывать и распаковывать ваши сообщения на каждом шаге вашей цепочки промисов.\n\n#### Разделение значений\n\nИногда вы можете воспринять это как сигнал о том, что вы можете/должны разложить проблему на два или более промисов.\n\nПредставьте, что у вас есть функция `foo(..)`, которая обеспечивает два значения (`x` и `y`) асинхронно:\n\n```js\nfunction getY(x) {\n\treturn new Promise( function(resolve,reject){\n\t\tsetTimeout( function(){\n\t\t\tresolve( (3 * x) - 1 );\n\t\t}, 100 );\n\t} );\n}\n\nfunction foo(bar,baz) {\n\tvar x = bar * baz;\n\n\treturn getY( x )\n\t.then( function(y){\n\t\t// упаковать оба значения в контейнер\n\t\treturn [x,y];\n\t} );\n}\n\nfoo( 10, 20 )\n.then( function(msgs){\n\tvar x = msgs[0];\n\tvar y = msgs[1];\n\n\tconsole.log( x, y );\t// 200 599\n} );\n```\n\nСперва, давайте переставим то. что возвращает `foo(..)` чтобы нам не пришлось упаковывать `x` и `y` в единственное значение `массива`, чтобы для передачи через один промис. Вместо этого мы можем обернуть кажое значение в свой собственный промис:\n\n```js\nfunction foo(bar,baz) {\n\tvar x = bar * baz;\n\n\t// вернуть оба промиса\n\treturn [\n\t\tPromise.resolve( x ),\n\t\tgetY( x )\n\t];\n}\n\nPromise.all(\n\tfoo( 10, 20 )\n)\n.then( function(msgs){\n\tvar x = msgs[0];\n\tvar y = msgs[1];\n\n\tconsole.log( x, y );\n} );\n```\n\nДействительно ли `массив` промисов лучше, чем `массив` значений, переданных через один промис? Синтаксически это не является большим улучшением.\n\nНо этот подход больше отвечает теории дизайна промисов. Теперь легче в будущем рефакторить, чтобы разделить вычисление `x` и `y` на отдельные функции. Это Гораздо чище и гибче позволить вызывающему коду решать, как согласовать эти два промиса используя тут `Promise.all([ .. ])`, но, конечно, не единственный вариант, а не абстрагироваться от таких деталей внутри `foo(..)`.\n\n#### Распаковка/разбиение аргументов\n\nПрисвоения `var x = ..` и `var y = ..` - все еще неудобные накладные расходы. Мы можем использовать некоторые функциональные хитрости (благодарим за предоставленную информацию Реджинальда Брейтуэйта (Reginald Braithwaite), @raganwald в твиттере) во вспомогательной функции:\n\n```js\nfunction spread(fn) {\n\treturn Function.apply.bind( fn, null );\n}\n\nPromise.all(\n\tfoo( 10, 20 )\n)\n.then(\n\tspread( function(x,y){\n\t\tconsole.log( x, y );\t// 200 599\n\t} )\n)\n```\n\nЭто немного лучше! Конечно, вы можете встроить функциональную магию, чтобы избежать дополнительную функцию:\n\n```js\nPromise.all(\n\tfoo( 10, 20 )\n)\n.then( Function.apply.bind(\n\tfunction(x,y){\n\t\tconsole.log( x, y );\t// 200 599\n\t},\n\tnull\n) );\n```\n\nЭти трюки могут быть простыми, но у ES6 есть еще более лучший ответ для нас: деструктуризация. Форма присвоения с деструктуризацией массива выглядит как-то так:\n\n```js\nPromise.all(\n\tfoo( 10, 20 )\n)\n.then( function(msgs){\n\tvar [x,y] = msgs;\n\n\tconsole.log( x, y );\t// 200 599\n} );\n```\n\nНо лучше всего, ES6 предлагает формат деструктуризации параметра-массива:\n\n```js\nPromise.all(\n\tfoo( 10, 20 )\n)\n.then( function([x,y]){\n\tconsole.log( x, y );\t// 200 599\n} );\n```\n\nТеперь мы придерживаемся мантры \"одно значение на промис\", но сократили до минимума наш вспомогательный шаблон!\n\n**Примечание** Для получения дополнительной информации о форматах деструктуризации в ES6 см. книгу *За пределами ES6* этой серии.\n\n### Единственное разрешение\n\nОдним из наиболее характерных свойств промисов является то, что промис может быть разрешен только один раз (завершение или отказ). Для многих случаев использования асинхронного кода, вы получаете значение только один раз, поэтому это работает прекрасно.\n\nНо есть также множество асинхронных случаев, которые вписываются в другую модель - те, которые больше похожи на события и/или потоки данных. На первый взгляд неясно, насколько хорошо промисы могут вписаться в такие сценарии использования, если это вообще возможно. Без значительной абстракции поверх промисов, они будут совершенно не подходить для обработки множественного разрешения значений.\n\nПредставьте себе сценарий, в котором вы хотите запустить последовательность асинхронных шагов в ответ на стимул (например, событие), который может произойти несколько раз, например, нажатие кнопки.\n\nЭто, вероятно, не будет работать так, как вы хотите:\n\n```js\n// `click(..)` привязывает событие `\"click\"` к элементу DOM\n// `request(..)` это ранее определенный Ajax-запрос с поддержкой промисов\n\nvar p = new Promise( function(resolve,reject){\n\tclick( \"#mybtn\", resolve );\n} );\n\np.then( function(evt){\n\tvar btnID = evt.currentTarget.id;\n\treturn request( \"http://some.url.1/?id=\" + btnID );\n} )\n.then( function(text){\n\tconsole.log( text );\n} );\n```\n\nПриведенное здесь поведение работает только в том случае, если ваше приложение требует, чтобы кнопка была нажата только один раз. Если кнопка нажата второй раз, промис `p` уже был разрешен, поэтому второй вызов `resolve(..)` будет проигнорирован.\n\nВместо этого вам, вероятно, придется изменить парадигму, создавая совершенно новую цепочку промисов для каждого срабатывания события:\n\n```js\nclick( \"#mybtn\", function(evt){\n\tvar btnID = evt.currentTarget.id;\n\n\trequest( \"http://some.url.1/?id=\" + btnID )\n\t.then( function(text){\n\t\tconsole.log( text );\n\t} );\n} );\n```\n\nЭтот подход *работает* в том смысле, что для каждого события `\"click\"` на кнопке будет запускаться совершенно новая последовательность промисов.\n\nНо помимо безобразия, связанного с необходимостью определять всю цепочку промисов внутри обработчика события, эта конструкция в некоторых отношениях нарушает идею разделения обязанностей/возможностей (SoC). Вполне возможно, что вы захотите определить обработчик события в другом месте вашего кода, а не там, где вы определяете *ответ* на событие (цепочка промисов). Это довольно неудобно делать в этом шаблоне без вспомогательных механизмов..\n\n**Примечание** Другой способ сформулировать это ограничение заключается в том, что было бы неплохо, если бы мы могли создать некую \"наблюдаемую штуку\", на которую мы могли бы подписать цепочку промисов. Существуют библиотеки, которые создали такие абстракции (такие как RxJS -- http://rxjs.codeplex.com/), но абстракции могут показаться настолько тяжелыми, что вы больше не можете видеть природу промисов. Такая тяжелая абстракция заставляет задуматься о таких важных вопросах, как: являются ли (вне промисов) эти механизмы настолько *надежными*, насколько сами промисы были разработаны для этого. Мы вернемся к шаблону \"Наблюдаемый\" в Приложении B.\n\n### Инерция\n\nОдним из конкретных препятствий для начала использования промисов в вашем собственном коде является весь существующий код, который еще не поддерживает промисы. Если у вас много кода, основанного на колбеках, гораздо проще просто продолжать кодировать в том же стиле.\n\n\"Кодовая база в движении (с колбеками) будет оставаться в движении (с колбеками), если не будут приняты меры со стороны умного, знающего промисы разработчика.\"\n\nПромисы предлагают другую парадигму, и поэтому подход к коду может быть разным - от просто немного другого до, в некоторых случаях, радикально другого. Вы должны быть целенаправленными в этом, потому что промисы не будут просто естественным образом вытекать из тех же старых способов выполнения кода, которые до сих пор хорошо вам служили.\n\nРассмотрим следующий сценарий, основанный на колбеке:\n\n```js\nfunction foo(x,y,cb) {\n\tajax(\n\t\t\"http://some.url.1/?x=\" + x + \"&y=\" + y,\n\t\tcb\n\t);\n}\n\nfoo( 11, 31, function(err,text) {\n\tif (err) {\n\t\tconsole.error( err );\n\t}\n\telse {\n\t\tconsole.log( text );\n\t}\n} );\n```\n\nОчевидно ли сразу, каковы первые шаги по преобразованию этого кода, основанного на колбеках, в код, ориентированный на промисы? Зависит от вашего опыта. Чем больше у вас будет практики, тем естественнее оно будет ощущаться. Но, безусловно, Промисы не только в том, что на этикетке написано, как именно это сделать - универсального ответа не существует, так что ответственность лежит на вас.\n\nКак мы уже писали ранее, нам определенно требуется Ajax-функция, которая поддерживает промисы вместо колбеков, которую мы могли бы назвать `request(..)`. Вы можете сделать свою собственную, как мы уже делали. Но накладные расходы, связанные с необходимостью вручную определять промис-совместимые обертки для каждой функции, основанной на колбеках, снижают вероятность того, что вы вообще решите перейти на промис-совместимое кодирование.\n\nПромисы не дают прямого ответа на это ограничение. Однако, большинство библиотек промисов предлагают вспомогательные средства. Но даже без библиотеки, представьте вспомогательный код подобный этому:\n\n```js\n// защитная проверка в стиле безопасного полифила\nif (!Promise.wrap) {\n\tPromise.wrap = function(fn) {\n\t\treturn function() {\n\t\t\tvar args = [].slice.call( arguments );\n\n\t\t\treturn new Promise( function(resolve,reject){\n\t\t\t\tfn.apply(\n\t\t\t\t\tnull,\n\t\t\t\t\targs.concat( function(err,v){\n\t\t\t\t\t\tif (err) {\n\t\t\t\t\t\t\treject( err );\n\t\t\t\t\t\t}\n\t\t\t\t\t\telse {\n\t\t\t\t\t\t\tresolve( v );\n\t\t\t\t\t\t}\n\t\t\t\t\t} )\n\t\t\t\t);\n\t\t\t} );\n\t\t};\n\t};\n}\n```\n\nХорошо, это больше, чем просто маленькая тривиальная утилита. Однако, хотя это может выглядеть немного пугающе, все не так плохо, как вы думаете. Она принимает функцию, которая ожидает колбек в стиле ошибка-первым-аргументом, как свой последний параметр и возвращает новый, который автоматически создает промис в качестве возвращаемого значения и подставляет колбек за вас, присоединяя к завершению/отказу промиса.\n\nВместо того, чтобы тратить много времени на обсуждение того, *как* эта вспомогательная функция `Promise.wrap(..)` работает, давайте просто взглянем на то, как мы ее используем:\n\n```js\nvar request = Promise.wrap( ajax );\n\nrequest( \"http://some.url.1/\" )\n.then( .. )\n..\n```\n\nОго, это было довольно просто!\n\n`Promise.wrap(..)` **не** создает промис. Она создает функцию, которая создаст промисы. В каком-то смысле, промисо-генерирующая функция может рассматриваться как \"фабрика промисов\". Я предлагаю \"promisory\" в качестве названия для такой вещи (\"Promise\" + \"factory\" (промис + фабрика)).\n\nПроцесс обертывания функции, ожидающей колбек, в функцию с поддержкой промисов иногда называют \"поднятием\" (lifting) или \"промисификацией\" (promisifying). Но, похоже, нет стандартного термина для того, как следует называть результирующую функцию, кроме как \"поднятая функция\", поэтому мне больше нравится \"промисофабрика (promisory)\", поскольку я считаю его более описательным.\n\n**Примечание** Promisory - это не выдуманный термин. Это реальное слово, и его определение означает \"содержать или передать промис\". Именно это и делают эти функции, так что получается довольно идеальное терминологическое соответствие!\n\nТаким образом, `Promise.wrap(ajax)` создает промисофабрику для `ajax(..)`, который мы назвали `request(..)` и эта промисофабрика создает промисы для Ajax-ответов.\n\nЕсли бы все функции уже были бы промисофабриками, нам бы не пришлось создавать из самим, так что лишний шаг - это немного досадно. Но, по крайней мере, шаблон упаковки (обычно) повторяемый, поэтому мы можем поместить его во вспомогательную функцию `Promise.wrap(...)`, как показано на примере, чтобы облегчить кодирование промисов.\n\nИтак, возвращаясь к нашему предыдущему примеру, нам нужна промисофабрика для обоих `ajax(..)` и `foo(..)`:\n\n```js\n// создать промисофабрику для `ajax(..)`\nvar request = Promise.wrap( ajax );\n\n// отрефакторить `foo(..)`, но оставить его снаружи\n// на основе колбека для совместимости с другими\n// частями кода пока что, и использовать промис из\n// `request(..)` только внутри.\nfunction foo(x,y,cb) {\n\trequest(\n\t\t\"http://some.url.1/?x=\" + x + \"&y=\" + y\n\t)\n\t.then(\n\t\tfunction fulfilled(text){\n\t\t\tcb( null, text );\n\t\t},\n\t\tcb\n\t);\n}\n\n// теперь, для целей данного кода, сделаем\n// промисофабрику для `foo(..)`\nvar betterFoo = Promise.wrap( foo );\n\n// и используем эту промисофабрику\nbetterFoo( 11, 31 )\n.then(\n\tfunction fulfilled(text){\n\t\tconsole.log( text );\n\t},\n\tfunction rejected(err){\n\t\tconsole.error( err );\n\t}\n);\n```\n\nКонечно, в то время как мы рефакторим `foo(..)`, чтобы использовать нашу новую промисофабрику `request(..)`, мы могли бы просто превратить саму `foo(..)` в промисофабрику, вместо того, чтобы оставлять основу из колбеков и необходимость создания и использования последующей промисофабрики `betterFoo(..)`. Это решение зависит только от того. надо ли оставлять `foo(..)` колбеко-совместимой с другими частями кода или нет.\n\nПредставим:\n\n```js\n// `foo(..)` теперь является промисофабрикой, поскольку она\n// делегирует работу промисофабрике `request(..)`\nfunction foo(x,y) {\n\treturn request(\n\t\t\"http://some.url.1/?x=\" + x + \"&y=\" + y\n\t);\n}\n\nfoo( 11, 31 )\n.then( .. )\n..\n```\n\nВ то время как ES6 промисы не оснащены нативно вспомогательными функциями для такого обертывания с помощью промисофабрик, многие библиотеки предоставляют их, либо вы можете сами сделать свои собственные. В любом случае, это конкретное ограничение промисов можно устранить без особых проблем. (конечно, по сравнению с муками ада обратных вызовов!).\n\n### Неотменяемый промис\n\nКак только вы создадите промис и зарегистрируете для него обработчик завершения и/или отказа, не будет ничего снаружи, что вы могли бы сделать, чтобы остановить это движение, если произойдет что-то еще, что сделает эту задачу неактуальной.\n\n**Примечание** Многие библиотеки абстракций над промисами предоставляют возможности для отмены промисов, но это ужасная идея! Многие разработчики хотели бы, чтобы промисы были изначально спроектированы с возможностью внешней отмены, но проблема в том, что это позволило бы одному потребителю/наблюдателю промиса влиять на способность другого потребителя наблюдать тот же промис. Это нарушает достоверность (внешнюю неизменяемость) будущего значения и, более того, является воплощением анти-паттерна \"действие на расстоянии\" (\"action at a distance\" (http://en.wikipedia.org/wiki/Action_at_a_distance_%28computer_programming%29)). Каким бы полезным он ни казался, на самом деле он приведет вас к тому же кошмару, что и колбеки.\n\nРассмотрим наш сценарий с тайм-аутом промиса, описанный ранее:\n\n```js\nvar p = foo( 42 );\n\nPromise.race( [\n\tp,\n\ttimeoutPromise( 3000 )\n] )\n.then(\n\tdoSomething,\n\thandleError\n);\n\np.then( function(){\n\t// все равно происходит даже в случае тайм-аута :(\n} );\n```\n\n\"Тайм-аут\" был внешним по отношению к `p`, поэтому само `p` выполняется дальше, чего мы, вероятно, не хотим.\n\nОдним из вариантов может быть инвазивное определение колбеков разрешения:\n\n```js\nvar OK = true;\n\nvar p = foo( 42 );\n\nPromise.race( [\n\tp,\n\ttimeoutPromise( 3000 )\n\t.catch( function(err){\n\t\tOK = false;\n\t\tthrow err;\n\t} )\n] )\n.then(\n\tdoSomething,\n\thandleError\n);\n\np.then( function(){\n\tif (OK) {\n\t\t// выполняется только если не было тайм-аута! :)\n\t}\n} );\n```\n\nЭто ужасно. Это работает, но далеко от идеала. В общем случае следует стараться избегать таких сценариев.\n\nНо если не можете этого избежать, Уродливость этого решения должна быть подсказкой, что *отмена* - это функциональность, которая находится на более высоком уровне абстракции, поверх промисов. Я бы рекомендовал обращаться за помощью к библиотекам абстракций над промисами, а не разрабатывать их самостоятельно.\n\n**Примечание** Моя библиотека абстракций над промисами *asynquence* предоставляет именно такую абстракцию и возможность сделать `abort()` для последовательности, все они будут рассмотрены в Приложении А.\n\nОдиночный промис на самом деле не является механизмом управления потоком (по крайней мере, в сильно значимом смысле), а это именно то, к чему относится *отмена*; поэтому отмена промиса будет выглядеть неловко.\n\nВ отличие от этого, цепочка промисов, взятых в совокупности (то, что я люблю называть \"последовательность\") - *является* выражением управления потоком, и поэтому уместно, чтобы отмена была определена на этом уровне абстракции.\n\nНи один отдельный промис не должен быть отменяемым, но разумно, чтобы отменяемой была *последовательность*, поскольку вы не передаете последовательность как единое неизменяемое значение, как вы делаете это с обещанием.\n\n### Производительность промисов\n\nДанное ограничение является одновременно и простым, и сложным.\n\nСравнивая, сколько частей двигается в базовой цепочке асинхронных задач, основанных на колбеках, с цепочкой промисов, можно заметить, что в промисах происходит гораздо больше операций, а значит, они, естественно, по крайней мере немного медленнее. Вспомните простой список гарантий доверия, которые предоставляют промисы, по сравнению со специальным кодом решения, который пришлось бы накладывать поверх колбеков для достижения того же уровня защиты.\n\nБольше работы, больше защитных мер, что означает, что обещания *медленнее* по сравнению с чистыми, ненадежными колбеками. Это очевидно и, вероятно, просто для восприятия.\n\nНо насколько медленнее? Ну... На этот вопрос, на самом деле, невероятно сложно ответить всесторонне.\n\nЧестно говоря, это своего рода сравнение \"яблок с апельсинами\", так что, вероятно, это неправильный вопрос. На самом деле следует сравнить, насколько специализированная система колбеков со всеми теми же защитами, внедренными вручную, быстрее, чем реализация промисов.\n\nЕсли у промисов и есть обоснованное ограничение производительности, то оно заключается в том, что они не дают возможности выбирать, какие средства защиты надежности вам нужны или не нужны - вы получаете их все и всегда.\n\nТем не менее, если мы признаем, что промис в целом *немного медленнее*, чем его эквивалент в виде не-промис и ненадежного колбека, предполагая, что есть места, где вы можете оправдать отсутствие надежности - означает ли это, что промиса следует избегать повсеместно, как будто все ваше приложение управляется только самым быстрым кодом, какой только может быть?\n\nЕсли ваш код действительно такой, то **подходит ли JavaScript для таких задач?** JavaScript может быть оптимизирован для выполнения приложений с очень высокой производительностью (см. главу 5 и главу 6). Но действительно ли уместно зацикливаться на крошечных компромиссах производительности с промисами в свете всех преимуществ, которые они дают?\n\nЕще одна небольшая проблема заключается в том, что Promises делают *все* асинхронным, а это значит, что некоторые немедленно (синхронно) завершенные шаги все равно откладывают выполнение следующего шага до Задачи (см. главу 1). Это означает, что последовательность задач промиса может выполняться чуть медленнее, чем та же самая последовательность с колбеками.\n\nКонечно, вопрос заключается в следующем: стоят ли эти потенциальные снижения крошечных долей производительности всех остальных преимуществ промисов, которые мы изложили в этой главе?\n\nЯ считаю, что практически во всех случаях, когда производительность промисов кажется вам достаточно низкой, чтобы начать беспокоиться, в действительности это антипаттерн - оптимизировать преимущества надежности и комбинируемости промисов, избегая их полностью.\n\nВместо этого вам следует по умолчанию использовать их во всей кодовой базе, а затем профилировать и анализировать ключевые (критические) места вашего приложения. Являются ли промисы *действительно* узким местом, или они просто теоретически замедляют работу? Только *после этого*, вооружившись реальными контрольными показателями (см. главу 6), можно ответственно и разумно исключить промисы именно в тех критических областях, которые были выявлены.\n\nПромисы немного медленнее, но в обмен на это вы получаете много надежности, не-Залго предсказуемости, и встроенную способность к композиции. Может быть, ограничением является не их производительность, а ваше недостаточное восприятие их преимуществ?\n\n## Обзор\n\nОбещания - это круто. Используйте их. Они решают проблемы *инверсии управления*, которые мучают нас в коде, основанном только на колбеках.\n\nОни не избавляются от колбеков, а просто перепоручают их организацию надежному механизму-посреднику, который находится между нами и другой утилитой.\n\nЦепочки промисов также начинают решать (хотя, конечно, не идеально) проблему лучшего способа последовательного выражения потока асинхронного кода, что помогает нашему мозгу лучше планировать и поддерживать асинхронный JS-код. Мы увидим еще более удачное решение *этой* проблемы в следующей главе!\n"
},
{
"path": "async & performance/ch4.md",
"content": "# You Don't Know JS: Async & Performance\n# Chapter 4: Generators\n\nIn Chapter 2, we identified two key drawbacks to expressing async flow control with callbacks:\n\n* Callback-based async doesn't fit how our brain plans out steps of a task.\n* Callbacks aren't trustable or composable because of *inversion of control*.\n\nIn Chapter 3, we detailed how Promises uninvert the *inversion of control* of callbacks, restoring trustability/composability.\n\nNow we turn our attention to expressing async flow control in a sequential, synchronous-looking fashion. The \"magic\" that makes it possible is ES6 **generators**.\n\n## Breaking Run-to-Completion\n\nIn Chapter 1, we explained an expectation that JS developers almost universally rely on in their code: once a function starts executing, it runs until it completes, and no other code can interrupt and run in between.\n\nAs bizarre as it may seem, ES6 introduces a new type of function that does not behave with the run-to-completion behavior. This new type of function is called a \"generator.\"\n\nTo understand the implications, let's consider this example:\n\n```js\nvar x = 1;\n\nfunction foo() {\n\tx++;\n\tbar();\t\t\t\t// <-- what about this line?\n\tconsole.log( \"x:\", x );\n}\n\nfunction bar() {\n\tx++;\n}\n\nfoo();\t\t\t\t\t// x: 3\n```\n\nIn this example, we know for sure that `bar()` runs in between `x++` and `console.log(x)`. But what if `bar()` wasn't there? Obviously the result would be `2` instead of `3`.\n\nNow let's twist your brain. What if `bar()` wasn't present, but it could still somehow run between the `x++` and `console.log(x)` statements? How would that be possible?\n\nIn **preemptive** multithreaded languages, it would essentially be possible for `bar()` to \"interrupt\" and run at exactly the right moment between those two statements. But JS is not preemptive, nor is it (currently) multithreaded. And yet, a **cooperative** form of this \"interruption\" (concurrency) is possible, if `foo()` itself could somehow indicate a \"pause\" at that part in the code.\n\n**Note:** I use the word \"cooperative\" not only because of the connection to classical concurrency terminology (see Chapter 1), but because as you'll see in the next snippet, the ES6 syntax for indicating a pause point in code is `yield` -- suggesting a politely *cooperative* yielding of control.\n\nHere's the ES6 code to accomplish such cooperative concurrency:\n\n```js\nvar x = 1;\n\nfunction *foo() {\n\tx++;\n\tyield; // pause!\n\tconsole.log( \"x:\", x );\n}\n\nfunction bar() {\n\tx++;\n}\n```\n\n**Note:** You will likely see most other JS documentation/code that will format a generator declaration as `function* foo() { .. }` instead of as I've done here with `function *foo() { .. }` -- the only difference being the stylistic positioning of the `*`. The two forms are functionally/syntactically identical, as is a third `function*foo() { .. }` (no space) form. There are arguments for both styles, but I basically prefer `function *foo..` because it then matches when I reference a generator in writing with `*foo()`. If I said only `foo()`, you wouldn't know as clearly if I was talking about a generator or a regular function. It's purely a stylistic preference.\n\nNow, how can we run the code in that previous snippet such that `bar()` executes at the point of the `yield` inside of `*foo()`?\n\n```js\n// construct an iterator `it` to control the generator\nvar it = foo();\n\n// start `foo()` here!\nit.next();\nx;\t\t\t\t\t\t// 2\nbar();\nx;\t\t\t\t\t\t// 3\nit.next();\t\t\t\t// x: 3\n```\n\nOK, there's quite a bit of new and potentially confusing stuff in those two code snippets, so we've got plenty to wade through. But before we explain the different mechanics/syntax with ES6 generators, let's walk through the behavior flow:\n\n1. The `it = foo()` operation does *not* execute the `*foo()` generator yet, but it merely constructs an *iterator* that will control its execution. More on *iterators* in a bit.\n2. The first `it.next()` starts the `*foo()` generator, and runs the `x++` on the first line of `*foo()`.\n3. `*foo()` pauses at the `yield` statement, at which point that first `it.next()` call finishes. At the moment, `*foo()` is still running and active, but it's in a paused state.\n4. We inspect the value of `x`, and it's now `2`.\n5. We call `bar()`, which increments `x` again with `x++`.\n6. We inspect the value of `x` again, and it's now `3`.\n7. The final `it.next()` call resumes the `*foo()` generator from where it was paused, and runs the `console.log(..)` statement, which uses the current value of `x` of `3`.\n\nClearly, `*foo()` started, but did *not* run-to-completion -- it paused at the `yield`. We resumed `*foo()` later, and let it finish, but that wasn't even required.\n\nSo, a generator is a special kind of function that can start and stop one or more times, and doesn't necessarily ever have to finish. While it won't be terribly obvious yet why that's so powerful, as we go throughout the rest of this chapter, that will be one of the fundamental building blocks we use to construct generators-as-async-flow-control as a pattern for our code.\n\n### Input and Output\n\nA generator function is a special function with the new processing model we just alluded to. But it's still a function, which means it still has some basic tenets that haven't changed -- namely, that it still accepts arguments (aka \"input\"), and that it can still return a value (aka \"output\"):\n\n```js\nfunction *foo(x,y) {\n\treturn x * y;\n}\n\nvar it = foo( 6, 7 );\n\nvar res = it.next();\n\nres.value;\t\t// 42\n```\n\nWe pass in the arguments `6` and `7` to `*foo(..)` as the parameters `x` and `y`, respectively. And `*foo(..)` returns the value `42` back to the calling code.\n\nWe now see a difference with how the generator is invoked compared to a normal function. `foo(6,7)` obviously looks familiar. But subtly, the `*foo(..)` generator hasn't actually run yet as it would have with a function.\n\nInstead, we're just creating an *iterator* object, which we assign to the variable `it`, to control the `*foo(..)` generator. Then we call `it.next()`, which instructs the `*foo(..)` generator to advance from its current location, stopping either at the next `yield` or end of the generator.\n\nThe result of that `next(..)` call is an object with a `value` property on it holding whatever value (if anything) was returned from `*foo(..)`. In other words, `yield` caused a value to be sent out from the generator during the middle of its execution, kind of like an intermediate `return`.\n\nAgain, it won't be obvious yet why we need this whole indirect *iterator* object to control the generator. We'll get there, I *promise*.\n\n#### Iteration Messaging\n\nIn addition to generators accepting arguments and having return values, there's even more powerful and compelling input/output messaging capability built into them, via `yield` and `next(..)`.\n\nConsider:\n\n```js\nfunction *foo(x) {\n\tvar y = x * (yield);\n\treturn y;\n}\n\nvar it = foo( 6 );\n\n// start `foo(..)`\nit.next();\n\nvar res = it.next( 7 );\n\nres.value;\t\t// 42\n```\n\nFirst, we pass in `6` as the parameter `x`. Then we call `it.next()`, and it starts up `*foo(..)`.\n\nInside `*foo(..)`, the `var y = x ..` statement starts to be processed, but then it runs across a `yield` expression. At that point, it pauses `*foo(..)` (in the middle of the assignment statement!), and essentially requests the calling code to provide a result value for the `yield` expression. Next, we call `it.next( 7 )`, which is passing the `7` value back in to *be* that result of the paused `yield` expression.\n\nSo, at this point, the assignment statement is essentially `var y = 6 * 7`. Now, `return y` returns that `42` value back as the result of the `it.next( 7 )` call.\n\nNotice something very important but also easily confusing, even to seasoned JS developers: depending on your perspective, there's a mismatch between the `yield` and the `next(..)` call. In general, you're going to have one more `next(..)` call than you have `yield` statements -- the preceding snippet has one `yield` and two `next(..)` calls.\n\nWhy the mismatch?\n\nBecause the first `next(..)` always starts a generator, and runs to the first `yield`. But it's the second `next(..)` call that fulfills the first paused `yield` expression, and the third `next(..)` would fulfill the second `yield`, and so on.\n\n##### Tale of Two Questions\n\nActually, which code you're thinking about primarily will affect whether there's a perceived mismatch or not.\n\nConsider only the generator code:\n\n```js\nvar y = x * (yield);\nreturn y;\n```\n\nThis **first** `yield` is basically *asking a question*: \"What value should I insert here?\"\n\nWho's going to answer that question? Well, the **first** `next()` has already run to get the generator up to this point, so obviously *it* can't answer the question. So, the **second** `next(..)` call must answer the question *posed* by the **first** `yield`.\n\nSee the mismatch -- second-to-first?\n\nBut let's flip our perspective. Let's look at it not from the generator's point of view, but from the iterator's point of view.\n\nTo properly illustrate this perspective, we also need to explain that messages can go in both directions -- `yield ..` as an expression can send out messages in response to `next(..)` calls, and `next(..)` can send values to a paused `yield` expression. Consider this slightly adjusted code:\n\n```js\nfunction *foo(x) {\n\tvar y = x * (yield \"Hello\");\t// <-- yield a value!\n\treturn y;\n}\n\nvar it = foo( 6 );\n\nvar res = it.next();\t// first `next()`, don't pass anything\nres.value;\t\t\t\t// \"Hello\"\n\nres = it.next( 7 );\t\t// pass `7` to waiting `yield`\nres.value;\t\t\t\t// 42\n```\n\n`yield ..` and `next(..)` pair together as a two-way message passing system **during the execution of the generator**.\n\nSo, looking only at the *iterator* code:\n\n```js\nvar res = it.next();\t// first `next()`, don't pass anything\nres.value;\t\t\t\t// \"Hello\"\n\nres = it.next( 7 );\t\t// pass `7` to waiting `yield`\nres.value;\t\t\t\t// 42\n```\n\n**Note:** We don't pass a value to the first `next()` call, and that's on purpose. Only a paused `yield` could accept such a value passed by a `next(..)`, and at the beginning of the generator when we call the first `next()`, there **is no paused `yield`** to accept such a value. The specification and all compliant browsers just silently **discard** anything passed to the first `next()`. It's still a bad idea to pass a value, as you're just creating silently \"failing\" code that's confusing. So, always start a generator with an argument-free `next()`.\n\nThe first `next()` call (with nothing passed to it) is basically *asking a question*: \"What *next* value does the `*foo(..)` generator have to give me?\" And who answers this question? The first `yield \"hello\"` expression.\n\nSee? No mismatch there.\n\nDepending on *who* you think about asking the question, there is either a mismatch between the `yield` and `next(..)` calls, or not.\n\nBut wait! There's still an extra `next()` compared to the number of `yield` statements. So, that final `it.next(7)` call is again asking the question about what *next* value the generator will produce. But there's no more `yield` statements left to answer, is there? So who answers?\n\nThe `return` statement answers the question!\n\nAnd if there **is no `return`** in your generator -- `return` is certainly not any more required in generators than in regular functions -- there's always an assumed/implicit `return;` (aka `return undefined;`), which serves the purpose of default answering the question *posed* by the final `it.next(7)` call.\n\nThese questions and answers -- the two-way message passing with `yield` and `next(..)` -- are quite powerful, but it's not obvious at all how these mechanisms are connected to async flow control. We're getting there!\n\n### Multiple Iterators\n\nIt may appear from the syntactic usage that when you use an *iterator* to control a generator, you're controlling the declared generator function itself. But there's a subtlety that's easy to miss: each time you construct an *iterator*, you are implicitly constructing an instance of the generator which that *iterator* will control.\n\nYou can have multiple instances of the same generator running at the same time, and they can even interact:\n\n```js\nfunction *foo() {\n\tvar x = yield 2;\n\tz++;\n\tvar y = yield (x * z);\n\tconsole.log( x, y, z );\n}\n\nvar z = 1;\n\nvar it1 = foo();\nvar it2 = foo();\n\nvar val1 = it1.next().value;\t\t\t// 2 <-- yield 2\nvar val2 = it2.next().value;\t\t\t// 2 <-- yield 2\n\nval1 = it1.next( val2 * 10 ).value;\t\t// 40 <-- x:20, z:2\nval2 = it2.next( val1 * 5 ).value;\t\t// 600 <-- x:200, z:3\n\nit1.next( val2 / 2 );\t\t\t\t\t// y:300\n\t\t\t\t\t\t\t\t\t\t// 20 300 3\nit2.next( val1 / 4 );\t\t\t\t\t// y:10\n\t\t\t\t\t\t\t\t\t\t// 200 10 3\n```\n\n**Warning:** The most common usage of multiple instances of the same generator running concurrently is not such interactions, but when the generator is producing its own values without input, perhaps from some independently connected resource. We'll talk more about value production in the next section.\n\nLet's briefly walk through the processing:\n\n1. Both instances of `*foo()` are started at the same time, and both `next()` calls reveal a `value` of `2` from the `yield 2` statements, respectively.\n2. `val2 * 10` is `2 * 10`, which is sent into the first generator instance `it1`, so that `x` gets value `20`. `z` is incremented from `1` to `2`, and then `20 * 2` is `yield`ed out, setting `val1` to `40`.\n3. `val1 * 5` is `40 * 5`, which is sent into the second generator instance `it2`, so that `x` gets value `200`. `z` is incremented again, from `2` to `3`, and then `200 * 3` is `yield`ed out, setting `val2` to `600`.\n4. `val2 / 2` is `600 / 2`, which is sent into the first generator instance `it1`, so that `y` gets value `300`, then printing out `20 300 3` for its `x y z` values, respectively.\n5. `val1 / 4` is `40 / 4`, which is sent into the second generator instance `it2`, so that `y` gets value `10`, then printing out `200 10 3` for its `x y z` values, respectively.\n\nThat's a \"fun\" example to run through in your mind. Did you keep it straight?\n\n#### Interleaving\n\nRecall this scenario from the \"Run-to-completion\" section of Chapter 1:\n\n```js\nvar a = 1;\nvar b = 2;\n\nfunction foo() {\n\ta++;\n\tb = b * a;\n\ta = b + 3;\n}\n\nfunction bar() {\n\tb--;\n\ta = 8 + b;\n\tb = a * 2;\n}\n```\n\nWith normal JS functions, of course either `foo()` can run completely first, or `bar()` can run completely first, but `foo()` cannot interleave its individual statements with `bar()`. So, there are only two possible outcomes to the preceding program.\n\nHowever, with generators, clearly interleaving (even in the middle of statements!) is possible:\n\n```js\nvar a = 1;\nvar b = 2;\n\nfunction *foo() {\n\ta++;\n\tyield;\n\tb = b * a;\n\ta = (yield b) + 3;\n}\n\nfunction *bar() {\n\tb--;\n\tyield;\n\ta = (yield 8) + b;\n\tb = a * (yield 2);\n}\n```\n\nDepending on what respective order the *iterators* controlling `*foo()` and `*bar()` are called, the preceding program could produce several different results. In other words, we can actually illustrate (in a sort of fake-ish way) the theoretical \"threaded race conditions\" circumstances discussed in Chapter 1, by interleaving the two generator interations over the same shared variables.\n\nFirst, let's make a helper called `step(..)` that controls an *iterator*:\n\n```js\nfunction step(gen) {\n\tvar it = gen();\n\tvar last;\n\n\treturn function() {\n\t\t// whatever is `yield`ed out, just\n\t\t// send it right back in the next time!\n\t\tlast = it.next( last ).value;\n\t};\n}\n```\n\n`step(..)` initializes a generator to create its `it` *iterator*, then returns a function which, when called, advances the *iterator* by one step. Additionally, the previously `yield`ed out value is sent right back in at the *next* step. So, `yield 8` will just become `8` and `yield b` will just be `b` (whatever it was at the time of `yield`).\n\nNow, just for fun, let's experiment to see the effects of interleaving these different chunks of `*foo()` and `*bar()`. We'll start with the boring base case, making sure `*foo()` totally finishes before `*bar()` (just like we did in Chapter 1):\n\n```js\n// make sure to reset `a` and `b`\na = 1;\nb = 2;\n\nvar s1 = step( foo );\nvar s2 = step( bar );\n\n// run `*foo()` completely first\ns1();\ns1();\ns1();\n\n// now run `*bar()`\ns2();\ns2();\ns2();\ns2();\n\nconsole.log( a, b );\t// 11 22\n```\n\nThe end result is `11` and `22`, just as it was in the Chapter 1 version. Now let's mix up the interleaving ordering and see how it changes the final values of `a` and `b`:\n\n```js\n// make sure to reset `a` and `b`\na = 1;\nb = 2;\n\nvar s1 = step( foo );\nvar s2 = step( bar );\n\ns2();\t\t// b--;\ns2();\t\t// yield 8\ns1();\t\t// a++;\ns2();\t\t// a = 8 + b;\n\t\t\t// yield 2\ns1();\t\t// b = b * a;\n\t\t\t// yield b\ns1();\t\t// a = b + 3;\ns2();\t\t// b = a * 2;\n```\n\nBefore I tell you the results, can you figure out what `a` and `b` are after the preceding program? No cheating!\n\n```js\nconsole.log( a, b );\t// 12 18\n```\n\n**Note:** As an exercise for the reader, try to see how many other combinations of results you can get back rearranging the order of the `s1()` and `s2()` calls. Don't forget you'll always need three `s1()` calls and four `s2()` calls. Recall the discussion earlier about matching `next()` with `yield` for the reasons why.\n\nYou almost certainly won't want to intentionally create *this* level of interleaving confusion, as it creates incredibly difficult to understand code. But the exercise is interesting and instructive to understand more about how multiple generators can run concurrently in the same shared scope, because there will be places where this capability is quite useful.\n\nWe'll discuss generator concurrency in more detail at the end of this chapter.\n\n## Generator'ing Values\n\nIn the previous section, we mentioned an interesting use for generators, as a way to produce values. This is **not** the main focus in this chapter, but we'd be remiss if we didn't cover the basics, especially because this use case is essentially the origin of the name: generators.\n\nWe're going to take a slight diversion into the topic of *iterators* for a bit, but we'll circle back to how they relate to generators and using a generator to *generate* values.\n\n### Producers and Iterators\n\nImagine you're producing a series of values where each value has a definable relationship to the previous value. To do this, you're going to need a stateful producer that remembers the last value it gave out.\n\nYou can implement something like that straightforwardly using a function closure (see the *Scope & Closures* title of this series):\n\n```js\nvar gimmeSomething = (function(){\n\tvar nextVal;\n\n\treturn function(){\n\t\tif (nextVal === undefined) {\n\t\t\tnextVal = 1;\n\t\t}\n\t\telse {\n\t\t\tnextVal = (3 * nextVal) + 6;\n\t\t}\n\n\t\treturn nextVal;\n\t};\n})();\n\ngimmeSomething();\t\t// 1\ngimmeSomething();\t\t// 9\ngimmeSomething();\t\t// 33\ngimmeSomething();\t\t// 105\n```\n\n**Note:** The `nextVal` computation logic here could have been simplified, but conceptually, we don't want to calculate the *next value* (aka `nextVal`) until the *next* `gimmeSomething()` call happens, because in general that could be a resource-leaky design for producers of more persistent or resource-limited values than simple `number`s.\n\nGenerating an arbitrary number series isn't a terribly realistic example. But what if you were generating records from a data source? You could imagine much the same code.\n\nIn fact, this task is a very common design pattern, usually solved by iterators. An *iterator* is a well-defined interface for stepping through a series of values from a producer. The JS interface for iterators, as it is in most languages, is to call `next()` each time you want the next value from the producer.\n\nWe could implement the standard *iterator* interface for our number series producer:\n\n```js\nvar something = (function(){\n\tvar nextVal;\n\n\treturn {\n\t\t// needed for `for..of` loops\n\t\t[Symbol.iterator]: function(){ return this; },\n\n\t\t// standard iterator interface method\n\t\tnext: function(){\n\t\t\tif (nextVal === undefined) {\n\t\t\t\tnextVal = 1;\n\t\t\t}\n\t\t\telse {\n\t\t\t\tnextVal = (3 * nextVal) + 6;\n\t\t\t}\n\n\t\t\treturn { done:false, value:nextVal };\n\t\t}\n\t};\n})();\n\nsomething.next().value;\t\t// 1\nsomething.next().value;\t\t// 9\nsomething.next().value;\t\t// 33\nsomething.next().value;\t\t// 105\n```\n\n**Note:** We'll explain why we need the `[Symbol.iterator]: ..` part of this code snippet in the \"Iterables\" section. Syntactically though, two ES6 features are at play. First, the `[ .. ]` syntax is called a *computed property name* (see the *this & Object Prototypes* title of this series). It's a way in an object literal definition to specify an expression and use the result of that expression as the name for the property. Next, `Symbol.iterator` is one of ES6's predefined special `Symbol` values (see the *ES6 & Beyond* title of this book series).\n\nThe `next()` call returns an object with two properties: `done` is a `boolean` value signaling the *iterator's* complete status; `value` holds the iteration value.\n\nES6 also adds the `for..of` loop, which means that a standard *iterator* can automatically be consumed with native loop syntax:\n\n```js\nfor (var v of something) {\n\tconsole.log( v );\n\n\t// don't let the loop run forever!\n\tif (v > 500) {\n\t\tbreak;\n\t}\n}\n// 1 9 33 105 321 969\n```\n\n**Note:** Because our `something` *iterator* always returns `done:false`, this `for..of` loop would run forever, which is why we put the `break` conditional in. It's totally OK for iterators to be never-ending, but there are also cases where the *iterator* will run over a finite set of values and eventually return a `done:true`.\n\nThe `for..of` loop automatically calls `next()` for each iteration -- it doesn't pass any values in to the `next()` -- and it will automatically terminate on receiving a `done:true`. It's quite handy for looping over a set of data.\n\nOf course, you could manually loop over iterators, calling `next()` and checking for the `done:true` condition to know when to stop:\n\n```js\nfor (\n\tvar ret;\n\t(ret = something.next()) && !ret.done;\n) {\n\tconsole.log( ret.value );\n\n\t// don't let the loop run forever!\n\tif (ret.value > 500) {\n\t\tbreak;\n\t}\n}\n// 1 9 33 105 321 969\n```\n\n**Note:** This manual `for` approach is certainly uglier than the ES6 `for..of` loop syntax, but its advantage is that it affords you the opportunity to pass in values to the `next(..)` calls if necessary.\n\nIn addition to making your own *iterators*, many built-in data structures in JS (as of ES6), like `array`s, also have default *iterators*:\n\n```js\nvar a = [1,3,5,7,9];\n\nfor (var v of a) {\n\tconsole.log( v );\n}\n// 1 3 5 7 9\n```\n\nThe `for..of` loop asks `a` for its *iterator*, and automatically uses it to iterate over `a`'s values.\n\n**Note:** It may seem a strange omission by ES6, but regular `object`s intentionally do not come with a default *iterator* the way `array`s do. The reasons go deeper than we will cover here. If all you want is to iterate over the properties of an object (with no particular guarantee of ordering), `Object.keys(..)` returns an `array`, which can then be used like `for (var k of Object.keys(obj)) { ..`. Such a `for..of` loop over an object's keys would be similar to a `for..in` loop, except that `Object.keys(..)` does not include properties from the `[[Prototype]]` chain while `for..in` does (see the *this & Object Prototypes* title of this series).\n\n### Iterables\n\nThe `something` object in our running example is called an *iterator*, as it has the `next()` method on its interface. But a closely related term is *iterable*, which is an `object` that **contains** an *iterator* that can iterate over its values.\n\nAs of ES6, the way to retrieve an *iterator* from an *iterable* is that the *iterable* must have a function on it, with the name being the special ES6 symbol value `Symbol.iterator`. When this function is called, it returns an *iterator*. Though not required, generally each call should return a fresh new *iterator*.\n\n`a` in the previous snippet is an *iterable*. The `for..of` loop automatically calls its `Symbol.iterator` function to construct an *iterator*. But we could of course call the function manually, and use the *iterator* it returns:\n\n```js\nvar a = [1,3,5,7,9];\n\nvar it = a[Symbol.iterator]();\n\nit.next().value;\t// 1\nit.next().value;\t// 3\nit.next().value;\t// 5\n..\n```\n\nIn the previous code listing that defined `something`, you may have noticed this line:\n\n```js\n[Symbol.iterator]: function(){ return this; }\n```\n\nThat little bit of confusing code is making the `something` value -- the interface of the `something` *iterator* -- also an *iterable*; it's now both an *iterable* and an *iterator*. Then, we pass `something` to the `for..of` loop:\n\n```js\nfor (var v of something) {\n\t..\n}\n```\n\nThe `for..of` loop expects `something` to be an *iterable*, so it looks for and calls its `Symbol.iterator` function. We defined that function to simply `return this`, so it just gives itself back, and the `for..of` loop is none the wiser.\n\n### Generator Iterator\n\nLet's turn our attention back to generators, in the context of *iterators*. A generator can be treated as a producer of values that we extract one at a time through an *iterator* interface's `next()` calls.\n\nSo, a generator itself is not technically an *iterable*, though it's very similar -- when you execute the generator, you get an *iterator* back:\n\n```js\nfunction *foo(){ .. }\n\nvar it = foo();\n```\n\nWe can implement the `something` infinite number series producer from earlier with a generator, like this:\n\n```js\nfunction *something() {\n\tvar nextVal;\n\n\twhile (true) {\n\t\tif (nextVal === undefined) {\n\t\t\tnextVal = 1;\n\t\t}\n\t\telse {\n\t\t\tnextVal = (3 * nextVal) + 6;\n\t\t}\n\n\t\tyield nextVal;\n\t}\n}\n```\n\n**Note:** A `while..true` loop would normally be a very bad thing to include in a real JS program, at least if it doesn't have a `break` or `return` in it, as it would likely run forever, synchronously, and block/lock-up the browser UI. However, in a generator, such a loop is generally totally OK if it has a `yield` in it, as the generator will pause at each iteration, `yield`ing back to the main program and/or to the event loop queue. To put it glibly, \"generators put the `while..true` back in JS programming!\"\n\nThat's a fair bit cleaner and simpler, right? Because the generator pauses at each `yield`, the state (scope) of the function `*something()` is kept around, meaning there's no need for the closure boilerplate to preserve variable state across calls.\n\nNot only is it simpler code -- we don't have to make our own *iterator* interface -- it actually is more reason-able code, because it more clearly expresses the intent. For example, the `while..true` loop tells us the generator is intended to run forever -- to keep *generating* values as long as we keep asking for them.\n\nAnd now we can use our shiny new `*something()` generator with a `for..of` loop, and you'll see it works basically identically:\n\n```js\nfor (var v of something()) {\n\tconsole.log( v );\n\n\t// don't let the loop run forever!\n\tif (v > 500) {\n\t\tbreak;\n\t}\n}\n// 1 9 33 105 321 969\n```\n\nBut don't skip over `for (var v of something()) ..`! We didn't just reference `something` as a value like in earlier examples, but instead called the `*something()` generator to get its *iterator* for the `for..of` loop to use.\n\nIf you're paying close attention, two questions may arise from this interaction between the generator and the loop:\n\n* Why couldn't we say `for (var v of something) ..`? Because `something` here is a generator, which is not an *iterable*. We have to call `something()` to construct a producer for the `for..of` loop to iterate over.\n* The `something()` call produces an *iterator*, but the `for..of` loop wants an *iterable*, right? Yep. The generator's *iterator* also has a `Symbol.iterator` function on it, which basically does a `return this`, just like the `something` *iterable* we defined earlier. In other words, a generator's *iterator* is also an *iterable*!\n\n#### Stopping the Generator\n\nIn the previous example, it would appear the *iterator* instance for the `*something()` generator was basically left in a suspended state forever after the `break` in the loop was called.\n\nBut there's a hidden behavior that takes care of that for you. \"Abnormal completion\" (i.e., \"early termination\") of the `for..of` loop -- generally caused by a `break`, `return`, or an uncaught exception -- sends a signal to the generator's *iterator* for it to terminate.\n\n**Note:** Technically, the `for..of` loop also sends this signal to the *iterator* at the normal completion of the loop. For a generator, that's essentially a moot operation, as the generator's *iterator* had to complete first so the `for..of` loop completed. However, custom *iterators* might desire to receive this additional signal from `for..of` loop consumers.\n\nWhile a `for..of` loop will automatically send this signal, you may wish to send the signal manually to an *iterator*; you do this by calling `return(..)`.\n\nIf you specify a `try..finally` clause inside the generator, it will always be run even when the generator is externally completed. This is useful if you need to clean up resources (database connections, etc.):\n\n```js\nfunction *something() {\n\ttry {\n\t\tvar nextVal;\n\n\t\twhile (true) {\n\t\t\tif (nextVal === undefined) {\n\t\t\t\tnextVal = 1;\n\t\t\t}\n\t\t\telse {\n\t\t\t\tnextVal = (3 * nextVal) + 6;\n\t\t\t}\n\n\t\t\tyield nextVal;\n\t\t}\n\t}\n\t// cleanup clause\n\tfinally {\n\t\tconsole.log( \"cleaning up!\" );\n\t}\n}\n```\n\nThe earlier example with `break` in the `for..of` loop will trigger the `finally` clause. But you could instead manually terminate the generator's *iterator* instance from the outside with `return(..)`:\n\n```js\nvar it = something();\nfor (var v of it) {\n\tconsole.log( v );\n\n\t// don't let the loop run forever!\n\tif (v > 500) {\n\t\tconsole.log(\n\t\t\t// complete the generator's iterator\n\t\t\tit.return( \"Hello World\" ).value\n\t\t);\n\t\t// no `break` needed here\n\t}\n}\n// 1 9 33 105 321 969\n// cleaning up!\n// Hello World\n```\n\nWhen we call `it.return(..)`, it immediately terminates the generator, which of course runs the `finally` clause. Also, it sets the returned `value` to whatever you passed in to `return(..)`, which is how `\"Hello World\"` comes right back out. We also don't need to include a `break` now because the generator's *iterator* is set to `done:true`, so the `for..of` loop will terminate on its next iteration.\n\nGenerators owe their namesake mostly to this *consuming produced values* use. But again, that's just one of the uses for generators, and frankly not even the main one we're concerned with in the context of this book.\n\nBut now that we more fully understand some of the mechanics of how they work, we can *next* turn our attention to how generators apply to async concurrency.\n\n## Iterating Generators Asynchronously\n\nWhat do generators have to do with async coding patterns, fixing problems with callbacks, and the like? Let's get to answering that important question.\n\nWe should revisit one of our scenarios from Chapter 3. Let's recall the callback approach:\n\n```js\nfunction foo(x,y,cb) {\n\tajax(\n\t\t\"http://some.url.1/?x=\" + x + \"&y=\" + y,\n\t\tcb\n\t);\n}\n\nfoo( 11, 31, function(err,text) {\n\tif (err) {\n\t\tconsole.error( err );\n\t}\n\telse {\n\t\tconsole.log( text );\n\t}\n} );\n```\n\nIf we wanted to express this same task flow control with a generator, we could do:\n\n```js\nfunction foo(x,y) {\n\tajax(\n\t\t\"http://some.url.1/?x=\" + x + \"&y=\" + y,\n\t\tfunction(err,data){\n\t\t\tif (err) {\n\t\t\t\t// throw an error into `*main()`\n\t\t\t\tit.throw( err );\n\t\t\t}\n\t\t\telse {\n\t\t\t\t// resume `*main()` with received `data`\n\t\t\t\tit.next( data );\n\t\t\t}\n\t\t}\n\t);\n}\n\nfunction *main() {\n\ttry {\n\t\tvar text = yield foo( 11, 31 );\n\t\tconsole.log( text );\n\t}\n\tcatch (err) {\n\t\tconsole.error( err );\n\t}\n}\n\nvar it = main();\n\n// start it all up!\nit.next();\n```\n\nAt first glance, this snippet is longer, and perhaps a little more complex looking, than the callback snippet before it. But don't let that impression get you off track. The generator snippet is actually **much** better! But there's a lot going on for us to explain.\n\nFirst, let's look at this part of the code, which is the most important:\n\n```js\nvar text = yield foo( 11, 31 );\nconsole.log( text );\n```\n\nThink about how that code works for a moment. We're calling a normal function `foo(..)` and we're apparently able to get back the `text` from the Ajax call, even though it's asynchronous.\n\nHow is that possible? If you recall the beginning of Chapter 1, we had almost identical code:\n\n```js\nvar data = ajax( \"..url 1..\" );\nconsole.log( data );\n```\n\nAnd that code didn't work! Can you spot the difference? It's the `yield` used in a generator.\n\nThat's the magic! That's what allows us to have what appears to be blocking, synchronous code, but it doesn't actually block the whole program; it only pauses/blocks the code in the generator itself.\n\nIn `yield foo(11,31)`, first the `foo(11,31)` call is made, which returns nothing (aka `undefined`), so we're making a call to request data, but we're actually then doing `yield undefined`. That's OK, because the code is not currently relying on a `yield`ed value to do anything interesting. We'll revisit this point later in the chapter.\n\nWe're not using `yield` in a message passing sense here, only in a flow control sense to pause/block. Actually, it will have message passing, but only in one direction, after the generator is resumed.\n\nSo, the generator pauses at the `yield`, essentially asking the question, \"what value should I return to assign to the variable `text`?\" Who's going to answer that question?\n\nLook at `foo(..)`. If the Ajax request is successful, we call:\n\n```js\nit.next( data );\n```\n\nThat's resuming the generator with the response data, which means that our paused `yield` expression receives that value directly, and then as it restarts the generator code, that value gets assigned to the local variable `text`.\n\nPretty cool, huh?\n\nTake a step back and consider the implications. We have totally synchronous-looking code inside the generator (other than the `yield` keyword itself), but hidden behind the scenes, inside of `foo(..)`, the operations can complete asynchronously.\n\n**That's huge!** That's a nearly perfect solution to our previously stated problem with callbacks not being able to express asynchrony in a sequential, synchronous fashion that our brains can relate to.\n\nIn essence, we are abstracting the asynchrony away as an implementation detail, so that we can reason synchronously/sequentially about our flow control: \"Make an Ajax request, and when it finishes print out the response.\" And of course, we just expressed two steps in the flow control, but this same capability extends without bounds, to let us express however many steps we need to.\n\n**Tip:** This is such an important realization, just go back and read the last three paragraphs again to let it sink in!\n\n### Synchronous Error Handling\n\nBut the preceding generator code has even more goodness to *yield* to us. Let's turn our attention to the `try..catch` inside the generator:\n\n```js\ntry {\n\tvar text = yield foo( 11, 31 );\n\tconsole.log( text );\n}\ncatch (err) {\n\tconsole.error( err );\n}\n```\n\nHow does this work? The `foo(..)` call is asynchronously completing, and doesn't `try..catch` fail to catch asynchronous errors, as we looked at in Chapter 3?\n\nWe already saw how the `yield` lets the assignment statement pause to wait for `foo(..)` to finish, so that the completed response can be assigned to `text`. The awesome part is that this `yield` pausing *also* allows the generator to `catch` an error. We throw that error into the generator with this part of the earlier code listing:\n\n```js\nif (err) {\n\t// throw an error into `*main()`\n\tit.throw( err );\n}\n```\n\nThe `yield`-pause nature of generators means that not only do we get synchronous-looking `return` values from async function calls, but we can also synchronously `catch` errors from those async function calls!\n\nSo we've seen we can throw errors *into* a generator, but what about throwing errors *out of* a generator? Exactly as you'd expect:\n\n```js\nfunction *main() {\n\tvar x = yield \"Hello World\";\n\n\tyield x.toLowerCase();\t// cause an exception!\n}\n\nvar it = main();\n\nit.next().value;\t\t\t// Hello World\n\ntry {\n\tit.next( 42 );\n}\ncatch (err) {\n\tconsole.error( err );\t// TypeError\n}\n```\n\nOf course, we could have manually thrown an error with `throw ..` instead of causing an exception.\n\nWe can even `catch` the same error that we `throw(..)` into the generator, essentially giving the generator a chance to handle it but if it doesn't, the *iterator* code must handle it:\n\n```js\nfunction *main() {\n\tvar x = yield \"Hello World\";\n\n\t// never gets here\n\tconsole.log( x );\n}\n\nvar it = main();\n\nit.next();\n\ntry {\n\t// will `*main()` handle this error? we'll see!\n\tit.throw( \"Oops\" );\n}\ncatch (err) {\n\t// nope, didn't handle it!\n\tconsole.error( err );\t\t\t// Oops\n}\n```\n\nSynchronous-looking error handling (via `try..catch`) with async code is a huge win for readability and reason-ability.\n\n## Generators + Promises\n\nIn our previous discussion, we showed how generators can be iterated asynchronously, which is a huge step forward in sequential reason-ability over the spaghetti mess of callbacks. But we lost something very important: the trustability and composability of Promises (see Chapter 3)!\n\nDon't worry -- we can get that back. The best of all worlds in ES6 is to combine generators (synchronous-looking async code) with Promises (trustable and composable).\n\nBut how?\n\nRecall from Chapter 3 the Promise-based approach to our running Ajax example:\n\n```js\nfunction foo(x,y) {\n\treturn request(\n\t\t\"http://some.url.1/?x=\" + x + \"&y=\" + y\n\t);\n}\n\nfoo( 11, 31 )\n.then(\n\tfunction(text){\n\t\tconsole.log( text );\n\t},\n\tfunction(err){\n\t\tconsole.error( err );\n\t}\n);\n```\n\nIn our earlier generator code for the running Ajax example, `foo(..)` returned nothing (`undefined`), and our *iterator* control code didn't care about that `yield`ed value.\n\nBut here the Promise-aware `foo(..)` returns a promise after making the Ajax call. That suggests that we could construct a promise with `foo(..)` and then `yield` it from the generator, and then the *iterator* control code would receive that promise.\n\nBut what should the *iterator* do with the promise?\n\nIt should listen for the promise to resolve (fulfillment or rejection), and then either resume the generator with the fulfillment message or throw an error into the generator with the rejection reason.\n\nLet me repeat that, because it's so important. The natural way to get the most out of Promises and generators is **to `yield` a Promise**, and wire that Promise to control the generator's *iterator*.\n\nLet's give it a try! First, we'll put the Promise-aware `foo(..)` together with the generator `*main()`:\n\n```js\nfunction foo(x,y) {\n\treturn request(\n\t\t\"http://some.url.1/?x=\" + x + \"&y=\" + y\n\t);\n}\n\nfunction *main() {\n\ttry {\n\t\tvar text = yield foo( 11, 31 );\n\t\tconsole.log( text );\n\t}\n\tcatch (err) {\n\t\tconsole.error( err );\n\t}\n}\n```\n\nThe most powerful revelation in this refactor is that the code inside `*main()` **did not have to change at all!** Inside the generator, whatever values are `yield`ed out is just an opaque implementation detail, so we're not even aware it's happening, nor do we need to worry about it.\n\nBut how are we going to run `*main()` now? We still have some of the implementation plumbing work to do, to receive and wire up the `yield`ed promise so that it resumes the generator upon resolution. We'll start by trying that manually:\n\n```js\nvar it = main();\n\nvar p = it.next().value;\n\n// wait for the `p` promise to resolve\np.then(\n\tfunction(text){\n\t\tit.next( text );\n\t},\n\tfunction(err){\n\t\tit.throw( err );\n\t}\n);\n```\n\nActually, that wasn't so painful at all, was it?\n\nThis snippet should look very similar to what we did earlier with the manually wired generator controlled by the error-first callback. Instead of an `if (err) { it.throw..`, the promise already splits fulfillment (success) and rejection (failure) for us, but otherwise the *iterator* control is identical.\n\nNow, we've glossed over some important details.\n\nMost importantly, we took advantage of the fact that we knew that `*main()` only had one Promise-aware step in it. What if we wanted to be able to Promise-drive a generator no matter how many steps it has? We certainly don't want to manually write out the Promise chain differently for each generator! What would be much nicer is if there was a way to repeat (aka \"loop\" over) the iteration control, and each time a Promise comes out, wait on its resolution before continuing.\n\nAlso, what if the generator throws out an error (intentionally or accidentally) during the `it.next(..)` call? Should we quit, or should we `catch` it and send it right back in? Similarly, what if we `it.throw(..)` a Promise rejection into the generator, but it's not handled, and comes right back out?\n\n### Promise-Aware Generator Runner\n\nThe more you start to explore this path, the more you realize, \"wow, it'd be great if there was just some utility to do it for me.\" And you're absolutely correct. This is such an important pattern, and you don't want to get it wrong (or exhaust yourself repeating it over and over), so your best bet is to use a utility that is specifically designed to *run* Promise-`yield`ing generators in the manner we've illustrated.\n\nSeveral Promise abstraction libraries provide just such a utility, including my *asynquence* library and its `runner(..)`, which will be discussed in Appendix A of this book.\n\nBut for the sake of learning and illustration, let's just define our own standalone utility that we'll call `run(..)`:\n\n```js\n// thanks to Benjamin Gruenbaum (@benjamingr on GitHub) for\n// big improvements here!\nfunction run(gen) {\n\tvar args = [].slice.call( arguments, 1), it;\n\n\t// initialize the generator in the current context\n\tit = gen.apply( this, args );\n\n\t// return a promise for the generator completing\n\treturn Promise.resolve()\n\t\t.then( function handleNext(value){\n\t\t\t// run to the next yielded value\n\t\t\tvar next = it.next( value );\n\n\t\t\treturn (function handleResult(next){\n\t\t\t\t// generator has completed running?\n\t\t\t\tif (next.done) {\n\t\t\t\t\treturn next.value;\n\t\t\t\t}\n\t\t\t\t// otherwise keep going\n\t\t\t\telse {\n\t\t\t\t\treturn Promise.resolve( next.value )\n\t\t\t\t\t\t.then(\n\t\t\t\t\t\t\t// resume the async loop on\n\t\t\t\t\t\t\t// success, sending the resolved\n\t\t\t\t\t\t\t// value back into the generator\n\t\t\t\t\t\t\thandleNext,\n\n\t\t\t\t\t\t\t// if `value` is a rejected\n\t\t\t\t\t\t\t// promise, propagate error back\n\t\t\t\t\t\t\t// into the generator for its own\n\t\t\t\t\t\t\t// error handling\n\t\t\t\t\t\t\tfunction handleErr(err) {\n\t\t\t\t\t\t\t\treturn Promise.resolve(\n\t\t\t\t\t\t\t\t\tit.throw( err )\n\t\t\t\t\t\t\t\t)\n\t\t\t\t\t\t\t\t.then( handleResult );\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t})(next);\n\t\t} );\n}\n```\n\nAs you can see, it's a quite a bit more complex than you'd probably want to author yourself, and you especially wouldn't want to repeat this code for each generator you use. So, a utility/library helper is definitely the way to go. Nevertheless, I encourage you to spend a few minutes studying that code listing to get a better sense of how to manage the generator+Promise negotiation.\n\nHow would you use `run(..)` with `*main()` in our *running* Ajax example?\n\n```js\nfunction *main() {\n\t// ..\n}\n\nrun( main );\n```\n\nThat's it! The way we wired `run(..)`, it will automatically advance the generator you pass to it, asynchronously until completion.\n\n**Note:** The `run(..)` we defined returns a promise which is wired to resolve once the generator is complete, or receive an uncaught exception if the generator doesn't handle it. We don't show that capability here, but we'll come back to it later in the chapter.\n\n#### ES7: `async` and `await`?\n\nThe preceding pattern -- generators yielding Promises that then control the generator's *iterator* to advance it to completion -- is such a powerful and useful approach, it would be nicer if we could do it without the clutter of the library utility helper (aka `run(..)`).\n\nThere's probably good news on that front. At the time of this writing, there's early but strong support for a proposal for more syntactic addition in this realm for the post-ES6, ES7-ish timeframe. Obviously, it's too early to guarantee the details, but there's a pretty decent chance it will shake out similar to the following:\n\n```js\nfunction foo(x,y) {\n\treturn request(\n\t\t\"http://some.url.1/?x=\" + x + \"&y=\" + y\n\t);\n}\n\nasync function main() {\n\ttry {\n\t\tvar text = await foo( 11, 31 );\n\t\tconsole.log( text );\n\t}\n\tcatch (err) {\n\t\tconsole.error( err );\n\t}\n}\n\nmain();\n```\n\nAs you can see, there's no `run(..)` call (meaning no need for a library utility!) to invoke and drive `main()` -- it's just called as a normal function. Also, `main()` isn't declared as a generator function anymore; it's a new kind of function: `async function`. And finally, instead of `yield`ing a Promise, we `await` for it to resolve.\n\nThe `async function` automatically knows what to do if you `await` a Promise -- it will pause the function (just like with generators) until the Promise resolves. We didn't illustrate it in this snippet, but calling an async function like `main()` automatically returns a promise that's resolved whenever the function finishes completely.\n\n**Tip:** The `async` / `await` syntax should look very familiar to readers with experience in C#, because it's basically identical.\n\nThe proposal essentially codifies support for the pattern we've already derived, into a syntactic mechanism: combining Promises with sync-looking flow control code. That's the best of both worlds combined, to effectively address practically all of the major concerns we outlined with callbacks.\n\nThe mere fact that such a ES7-ish proposal already exists and has early support and enthusiasm is a major vote of confidence in the future importance of this async pattern.\n\n### Promise Concurrency in Generators\n\nSo far, all we've demonstrated is a single-step async flow with Promises+generators. But real-world code will often have many async steps.\n\nIf you're not careful, the sync-looking style of generators may lull you into complacency with how you structure your async concurrency, leading to suboptimal performance patterns. So we want to spend a little time exploring the options.\n\nImagine a scenario where you need to fetch data from two different sources, then combine those responses to make a third request, and finally print out the last response. We explored a similar scenario with Promises in Chapter 3, but let's reconsider it in the context of generators.\n\nYour first instinct might be something like:\n\n```js\nfunction *foo() {\n\tvar r1 = yield request( \"http://some.url.1\" );\n\tvar r2 = yield request( \"http://some.url.2\" );\n\n\tvar r3 = yield request(\n\t\t\"http://some.url.3/?v=\" + r1 + \",\" + r2\n\t);\n\n\tconsole.log( r3 );\n}\n\n// use previously defined `run(..)` utility\nrun( foo );\n```\n\nThis code will work, but in the specifics of our scenario, it's not optimal. Can you spot why?\n\nBecause the `r1` and `r2` requests can -- and for performance reasons, *should* -- run concurrently, but in this code they will run sequentially; the `\"http://some.url.2\"` URL isn't Ajax fetched until after the `\"http://some.url.1\"` request is finished. These two requests are independent, so the better performance approach would likely be to have them run at the same time.\n\nBut how exactly would you do that with a generator and `yield`? We know that `yield` is only a single pause point in the code, so you can't really do two pauses at the same time.\n\nThe most natural and effective answer is to base the async flow on Promises, specifically on their capability to manage state in a time-independent fashion (see \"Future Value\" in Chapter 3).\n\nThe simplest approach:\n\n```js\nfunction *foo() {\n\t// make both requests \"in parallel\"\n\tvar p1 = request( \"http://some.url.1\" );\n\tvar p2 = request( \"http://some.url.2\" );\n\n\t// wait until both promises resolve\n\tvar r1 = yield p1;\n\tvar r2 = yield p2;\n\n\tvar r3 = yield request(\n\t\t\"http://some.url.3/?v=\" + r1 + \",\" + r2\n\t);\n\n\tconsole.log( r3 );\n}\n\n// use previously defined `run(..)` utility\nrun( foo );\n```\n\nWhy is this different from the previous snippet? Look at where the `yield` is and is not. `p1` and `p2` are promises for Ajax requests made concurrently (aka \"in parallel\"). It doesn't matter which one finishes first, because promises will hold onto their resolved state for as long as necessary.\n\nThen we use two subsequent `yield` statements to wait for and retrieve the resolutions from the promises (into `r1` and `r2`, respectively). If `p1` resolves first, the `yield p1` resumes first then waits on the `yield p2` to resume. If `p2` resolves first, it will just patiently hold onto that resolution value until asked, but the `yield p1` will hold on first, until `p1` resolves.\n\nEither way, both `p1` and `p2` will run concurrently, and both have to finish, in either order, before the `r3 = yield request..` Ajax request will be made.\n\nIf that flow control processing model sounds familiar, it's basically the same as what we identified in Chapter 3 as the \"gate\" pattern, enabled by the `Promise.all([ .. ])` utility. So, we could also express the flow control like this:\n\n```js\nfunction *foo() {\n\t// make both requests \"in parallel,\" and\n\t// wait until both promises resolve\n\tvar results = yield Promise.all( [\n\t\trequest( \"http://some.url.1\" ),\n\t\trequest( \"http://some.url.2\" )\n\t] );\n\n\tvar r1 = results[0];\n\tvar r2 = results[1];\n\n\tvar r3 = yield request(\n\t\t\"http://some.url.3/?v=\" + r1 + \",\" + r2\n\t);\n\n\tconsole.log( r3 );\n}\n\n// use previously defined `run(..)` utility\nrun( foo );\n```\n\n**Note:** As we discussed in Chapter 3, we can even use ES6 destructuring assignment to simplify the `var r1 = .. var r2 = ..` assignments, with `var [r1,r2] = results`.\n\nIn other words, all of the concurrency capabilities of Promises are available to us in the generator+Promise approach. So in any place where you need more than sequential this-then-that async flow control steps, Promises are likely your best bet.\n\n#### Promises, Hidden\n\nAs a word of stylistic caution, be careful about how much Promise logic you include **inside your generators**. The whole point of using generators for asynchrony in the way we've described is to create simple, sequential, sync-looking code, and to hide as much of the details of asynchrony away from that code as possible.\n\nFor example, this might be a cleaner approach:\n\n```js\n// note: normal function, not generator\nfunction bar(url1,url2) {\n\treturn Promise.all( [\n\t\trequest( url1 ),\n\t\trequest( url2 )\n\t] );\n}\n\nfunction *foo() {\n\t// hide the Promise-based concurrency details\n\t// inside `bar(..)`\n\tvar results = yield bar(\n\t\t\"http://some.url.1\",\n\t\t\"http://some.url.2\"\n\t);\n\n\tvar r1 = results[0];\n\tvar r2 = results[1];\n\n\tvar r3 = yield request(\n\t\t\"http://some.url.3/?v=\" + r1 + \",\" + r2\n\t);\n\n\tconsole.log( r3 );\n}\n\n// use previously defined `run(..)` utility\nrun( foo );\n```\n\nInside `*foo()`, it's cleaner and clearer that all we're doing is just asking `bar(..)` to get us some `results`, and we'll `yield`-wait on that to happen. We don't have to care that under the covers a `Promise.all([ .. ])` Promise composition will be used to make that happen.\n\n**We treat asynchrony, and indeed Promises, as an implementation detail.**\n\nHiding your Promise logic inside a function that you merely call from your generator is especially useful if you're going to do a sophisticated series flow-control. For example:\n\n```js\nfunction bar() {\n\tPromise.all( [\n\t\tbaz( .. )\n\t\t.then( .. ),\n\t\tPromise.race( [ .. ] )\n\t] )\n\t.then( .. )\n}\n```\n\nThat kind of logic is sometimes required, and if you dump it directly inside your generator(s), you've defeated most of the reason why you would want to use generators in the first place. We *should* intentionally abstract such details away from our generator code so that they don't clutter up the higher level task expression.\n\nBeyond creating code that is both functional and performant, you should also strive to make code that is as reason-able and maintainable as possible.\n\n**Note:** Abstraction is not *always* a healthy thing for programming -- many times it can increase complexity in exchange for terseness. But in this case, I believe it's much healthier for your generator+Promise async code than the alternatives. As with all such advice, though, pay attention to your specific situations and make proper decisions for you and your team.\n\n## Generator Delegation\n\nIn the previous section, we showed calling regular functions from inside a generator, and how that remains a useful technique for abstracting away implementation details (like async Promise flow). But the main drawback of using a normal function for this task is that it has to behave by the normal function rules, which means it cannot pause itself with `yield` like a generator can.\n\nIt may then occur to you that you might try to call one generator from another generator, using our `run(..)` helper, such as:\n\n```js\nfunction *foo() {\n\tvar r2 = yield request( \"http://some.url.2\" );\n\tvar r3 = yield request( \"http://some.url.3/?v=\" + r2 );\n\n\treturn r3;\n}\n\nfunction *bar() {\n\tvar r1 = yield request( \"http://some.url.1\" );\n\n\t// \"delegating\" to `*foo()` via `run(..)`\n\tvar r3 = yield run( foo );\n\n\tconsole.log( r3 );\n}\n\nrun( bar );\n```\n\nWe run `*foo()` inside of `*bar()` by using our `run(..)` utility again. We take advantage here of the fact that the `run(..)` we defined earlier returns a promise which is resolved when its generator is run to completion (or errors out), so if we `yield` out to a `run(..)` instance the promise from another `run(..)` call, it automatically pauses `*bar()` until `*foo()` finishes.\n\nBut there's an even better way to integrate calling `*foo()` into `*bar()`, and it's called `yield`-delegation. The special syntax for `yield`-delegation is: `yield * __` (notice the extra `*`). Before we see it work in our previous example, let's look at a simpler scenario:\n\n```js\nfunction *foo() {\n\tconsole.log( \"`*foo()` starting\" );\n\tyield 3;\n\tyield 4;\n\tconsole.log( \"`*foo()` finished\" );\n}\n\nfunction *bar() {\n\tyield 1;\n\tyield 2;\n\tyield *foo();\t// `yield`-delegation!\n\tyield 5;\n}\n\nvar it = bar();\n\nit.next().value;\t// 1\nit.next().value;\t// 2\nit.next().value;\t// `*foo()` starting\n\t\t\t\t\t// 3\nit.next().value;\t// 4\nit.next().value;\t// `*foo()` finished\n\t\t\t\t\t// 5\n```\n\n**Note:** Similar to a note earlier in the chapter where I explained why I prefer `function *foo() ..` instead of `function* foo() ..`, I also prefer -- differing from most other documentation on the topic -- to say `yield *foo()` instead of `yield* foo()`. The placement of the `*` is purely stylistic and up to your best judgment. But I find the consistency of styling attractive.\n\nHow does the `yield *foo()` delegation work?\n\nFirst, calling `foo()` creates an *iterator* exactly as we've already seen. Then, `yield *` delegates/transfers the *iterator* instance control (of the present `*bar()` generator) over to this other `*foo()` *iterator*.\n\nSo, the first two `it.next()` calls are controlling `*bar()`, but when we make the third `it.next()` call, now `*foo()` starts up, and now we're controlling `*foo()` instead of `*bar()`. That's why it's called delegation -- `*bar()` delegated its iteration control to `*foo()`.\n\nAs soon as the `it` *iterator* control exhausts the entire `*foo()` *iterator*, it automatically returns to controlling `*bar()`.\n\nSo now back to the previous example with the three sequential Ajax requests:\n\n```js\nfunction *foo() {\n\tvar r2 = yield request( \"http://some.url.2\" );\n\tvar r3 = yield request( \"http://some.url.3/?v=\" + r2 );\n\n\treturn r3;\n}\n\nfunction *bar() {\n\tvar r1 = yield request( \"http://some.url.1\" );\n\n\t// \"delegating\" to `*foo()` via `yield*`\n\tvar r3 = yield *foo();\n\n\tconsole.log( r3 );\n}\n\nrun( bar );\n```\n\nThe only difference between this snippet and the version used earlier is the use of `yield *foo()` instead of the previous `yield run(foo)`.\n\n**Note:** `yield *` yields iteration control, not generator control; when you invoke the `*foo()` generator, you're now `yield`-delegating to its *iterator*. But you can actually `yield`-delegate to any *iterable*; `yield *[1,2,3]` would consume the default *iterator* for the `[1,2,3]` array value.\n\n### Why Delegation?\n\nThe purpose of `yield`-delegation is mostly code organization, and in that way is symmetrical with normal function calling.\n\nImagine two modules that respectively provide methods `foo()` and `bar()`, where `bar()` calls `foo()`. The reason the two are separate is generally because the proper organization of code for the program calls for them to be in separate functions. For example, there may be cases where `foo()` is called standalone, and other places where `bar()` calls `foo()`.\n\nFor all these exact same reasons, keeping generators separate aids in program readability, maintenance, and debuggability. In that respect, `yield *` is a syntactic shortcut for manually iterating over the steps of `*foo()` while inside of `*bar()`.\n\nSuch manual approach would be especially complex if the steps in `*foo()` were asynchronous, which is why you'd probably need to use that `run(..)` utility to do it. And as we've shown, `yield *foo()` eliminates the need for a sub-instance of the `run(..)` utility (like `run(foo)`).\n\n### Delegating Messages\n\nYou may wonder how this `yield`-delegation works not just with *iterator* control but with the two-way message passing. Carefully follow the flow of messages in and out, through the `yield`-delegation:\n\n```js\nfunction *foo() {\n\tconsole.log( \"inside `*foo()`:\", yield \"B\" );\n\n\tconsole.log( \"inside `*foo()`:\", yield \"C\" );\n\n\treturn \"D\";\n}\n\nfunction *bar() {\n\tconsole.log( \"inside `*bar()`:\", yield \"A\" );\n\n\t// `yield`-delegation!\n\tconsole.log( \"inside `*bar()`:\", yield *foo() );\n\n\tconsole.log( \"inside `*bar()`:\", yield \"E\" );\n\n\treturn \"F\";\n}\n\nvar it = bar();\n\nconsole.log( \"outside:\", it.next().value );\n// outside: A\n\nconsole.log( \"outside:\", it.next( 1 ).value );\n// inside `*bar()`: 1\n// outside: B\n\nconsole.log( \"outside:\", it.next( 2 ).value );\n// inside `*foo()`: 2\n// outside: C\n\nconsole.log( \"outside:\", it.next( 3 ).value );\n// inside `*foo()`: 3\n// inside `*bar()`: D\n// outside: E\n\nconsole.log( \"outside:\", it.next( 4 ).value );\n// inside `*bar()`: 4\n// outside: F\n```\n\nPay particular attention to the processing steps after the `it.next(3)` call:\n\n1. The `3` value is passed (through the `yield`-delegation in `*bar()`) into the waiting `yield \"C\"` expression inside of `*foo()`.\n2. `*foo()` then calls `return \"D\"`, but this value doesn't get returned all the way back to the outside `it.next(3)` call.\n3. Instead, the `\"D\"` value is sent as the result of the waiting `yield *foo()` expression inside of `*bar()` -- this `yield`-delegation expression has essentially been paused while all of `*foo()` was exhausted. So `\"D\"` ends up inside of `*bar()` for it to print out.\n4. `yield \"E\"` is called inside of `*bar()`, and the `\"E\"` value is yielded to the outside as the result of the `it.next(3)` call.\n\nFrom the perspective of the external *iterator* (`it`), it doesn't appear any differently between controlling the initial generator or a delegated one.\n\nIn fact, `yield`-delegation doesn't even have to be directed to another generator; it can just be directed to a non-generator, general *iterable*. For example:\n\n```js\nfunction *bar() {\n\tconsole.log( \"inside `*bar()`:\", yield \"A\" );\n\n\t// `yield`-delegation to a non-generator!\n\tconsole.log( \"inside `*bar()`:\", yield *[ \"B\", \"C\", \"D\" ] );\n\n\tconsole.log( \"inside `*bar()`:\", yield \"E\" );\n\n\treturn \"F\";\n}\n\nvar it = bar();\n\nconsole.log( \"outside:\", it.next().value );\n// outside: A\n\nconsole.log( \"outside:\", it.next( 1 ).value );\n// inside `*bar()`: 1\n// outside: B\n\nconsole.log( \"outside:\", it.next( 2 ).value );\n// outside: C\n\nconsole.log( \"outside:\", it.next( 3 ).value );\n// outside: D\n\nconsole.log( \"outside:\", it.next( 4 ).value );\n// inside `*bar()`: undefined\n// outside: E\n\nconsole.log( \"outside:\", it.next( 5 ).value );\n// inside `*bar()`: 5\n// outside: F\n```\n\nNotice the differences in where the messages were received/reported between this example and the one previous.\n\nMost strikingly, the default `array` *iterator* doesn't care about any messages sent in via `next(..)` calls, so the values `2`, `3`, and `4` are essentially ignored. Also, because that *iterator* has no explicit `return` value (unlike the previously used `*foo()`), the `yield *` expression gets an `undefined` when it finishes.\n\n#### Exceptions Delegated, Too!\n\nIn the same way that `yield`-delegation transparently passes messages through in both directions, errors/exceptions also pass in both directions:\n\n```js\nfunction *foo() {\n\ttry {\n\t\tyield \"B\";\n\t}\n\tcatch (err) {\n\t\tconsole.log( \"error caught inside `*foo()`:\", err );\n\t}\n\n\tyield \"C\";\n\n\tthrow \"D\";\n}\n\nfunction *bar() {\n\tyield \"A\";\n\n\ttry {\n\t\tyield *foo();\n\t}\n\tcatch (err) {\n\t\tconsole.log( \"error caught inside `*bar()`:\", err );\n\t}\n\n\tyield \"E\";\n\n\tyield *baz();\n\n\t// note: can't get here!\n\tyield \"G\";\n}\n\nfunction *baz() {\n\tthrow \"F\";\n}\n\nvar it = bar();\n\nconsole.log( \"outside:\", it.next().value );\n// outside: A\n\nconsole.log( \"outside:\", it.next( 1 ).value );\n// outside: B\n\nconsole.log( \"outside:\", it.throw( 2 ).value );\n// error caught inside `*foo()`: 2\n// outside: C\n\nconsole.log( \"outside:\", it.next( 3 ).value );\n// error caught inside `*bar()`: D\n// outside: E\n\ntry {\n\tconsole.log( \"outside:\", it.next( 4 ).value );\n}\ncatch (err) {\n\tconsole.log( \"error caught outside:\", err );\n}\n// error caught outside: F\n```\n\nSome things to note from this snippet:\n\n1. When we call `it.throw(2)`, it sends the error message `2` into `*bar()`, which delegates that to `*foo()`, which then `catch`es it and handles it gracefully. Then, the `yield \"C\"` sends `\"C\"` back out as the return `value` from the `it.throw(2)` call.\n2. The `\"D\"` value that's next `throw`n from inside `*foo()` propagates out to `*bar()`, which `catch`es it and handles it gracefully. Then the `yield \"E\"` sends `\"E\"` back out as the return `value` from the `it.next(3)` call.\n3. Next, the exception `throw`n from `*baz()` isn't caught in `*bar()` -- though we did `catch` it outside -- so both `*baz()` and `*bar()` are set to a completed state. After this snippet, you would not be able to get the `\"G\"` value out with any subsequent `next(..)` call(s) -- they will just return `undefined` for `value`.\n\n### Delegating Asynchrony\n\nLet's finally get back to our earlier `yield`-delegation example with the multiple sequential Ajax requests:\n\n```js\nfunction *foo() {\n\tvar r2 = yield request( \"http://some.url.2\" );\n\tvar r3 = yield request( \"http://some.url.3/?v=\" + r2 );\n\n\treturn r3;\n}\n\nfunction *bar() {\n\tvar r1 = yield request( \"http://some.url.1\" );\n\n\tvar r3 = yield *foo();\n\n\tconsole.log( r3 );\n}\n\nrun( bar );\n```\n\nInstead of calling `yield run(foo)` inside of `*bar()`, we just call `yield *foo()`.\n\nIn the previous version of this example, the Promise mechanism (controlled by `run(..)`) was used to transport the value from `return r3` in `*foo()` to the local variable `r3` inside `*bar()`. Now, that value is just returned back directly via the `yield *` mechanics.\n\nOtherwise, the behavior is pretty much identical.\n\n### Delegating \"Recursion\"\n\nOf course, `yield`-delegation can keep following as many delegation steps as you wire up. You could even use `yield`-delegation for async-capable generator \"recursion\" -- a generator `yield`-delegating to itself:\n\n```js\nfunction *foo(val) {\n\tif (val > 1) {\n\t\t// generator recursion\n\t\tval = yield *foo( val - 1 );\n\t}\n\n\treturn yield request( \"http://some.url/?v=\" + val );\n}\n\nfunction *bar() {\n\tvar r1 = yield *foo( 3 );\n\tconsole.log( r1 );\n}\n\nrun( bar );\n```\n\n**Note:** Our `run(..)` utility could have been called with `run( foo, 3 )`, because it supports additional parameters being passed along to the initialization of the generator. However, we used a parameter-free `*bar()` here to highlight the flexibility of `yield *`.\n\nWhat processing steps follow from that code? Hang on, this is going to be quite intricate to describe in detail:\n\n1. `run(bar)` starts up the `*bar()` generator.\n2. `foo(3)` creates an *iterator* for `*foo(..)` and passes `3` as its `val` parameter.\n3. Because `3 > 1`, `foo(2)` creates another *iterator* and passes in `2` as its `val` parameter.\n4. Because `2 > 1`, `foo(1)` creates yet another *iterator* and passes in `1` as its `val` parameter.\n5. `1 > 1` is `false`, so we next call `request(..)` with the `1` value, and get a promise back for that first Ajax call.\n6. That promise is `yield`ed out, which comes back to the `*foo(2)` generator instance.\n7. The `yield *` passes that promise back out to the `*foo(3)` generator instance. Another `yield *` passes the promise out to the `*bar()` generator instance. And yet again another `yield *` passes the promise out to the `run(..)` utility, which will wait on that promise (for the first Ajax request) to proceed.\n8. When the promise resolves, its fulfillment message is sent to resume `*bar()`, which passes through the `yield *` into the `*foo(3)` instance, which then passes through the `yield *` to the `*foo(2)` generator instance, which then passes through the `yield *` to the normal `yield` that's waiting in the `*foo(3)` generator instance.\n9. That first call's Ajax response is now immediately `return`ed from the `*foo(3)` generator instance, which sends that value back as the result of the `yield *` expression in the `*foo(2)` instance, and assigned to its local `val` variable.\n10. Inside `*foo(2)`, a second Ajax request is made with `request(..)`, whose promise is `yield`ed back to the `*foo(1)` instance, and then `yield *` propagates all the way out to `run(..)` (step 7 again). When the promise resolves, the second Ajax response propagates all the way back into the `*foo(2)` generator instance, and is assigned to its local `val` variable.\n11. Finally, the third Ajax request is made with `request(..)`, its promise goes out to `run(..)`, and then its resolution value comes all the way back, which is then `return`ed so that it comes back to the waiting `yield *` expression in `*bar()`.\n\nPhew! A lot of crazy mental juggling, huh? You might want to read through that a few more times, and then go grab a snack to clear your head!\n\n## Generator Concurrency\n\nAs we discussed in both Chapter 1 and earlier in this chapter, two simultaneously running \"processes\" can cooperatively interleave their operations, and many times this can *yield* (pun intended) very powerful asynchrony expressions.\n\nFrankly, our earlier examples of concurrency interleaving of multiple generators showed how to make it really confusing. But we hinted that there's places where this capability is quite useful.\n\nRecall a scenario we looked at in Chapter 1, where two different simultaneous Ajax response handlers needed to coordinate with each other to make sure that the data communication was not a race condition. We slotted the responses into the `res` array like this:\n\n```js\nfunction response(data) {\n\tif (data.url == \"http://some.url.1\") {\n\t\tres[0] = data;\n\t}\n\telse if (data.url == \"http://some.url.2\") {\n\t\tres[1] = data;\n\t}\n}\n```\n\nBut how can we use multiple generators concurrently for this scenario?\n\n```js\n// `request(..)` is a Promise-aware Ajax utility\n\nvar res = [];\n\nfunction *reqData(url) {\n\tres.push(\n\t\tyield request( url )\n\t);\n}\n```\n\n**Note:** We're going to use two instances of the `*reqData(..)` generator here, but there's no difference to running a single instance of two different generators; both approaches are reasoned about identically. We'll see two different generators coordinating in just a bit.\n\nInstead of having to manually sort out `res[0]` and `res[1]` assignments, we'll use coordinated ordering so that `res.push(..)` properly slots the values in the expected and predictable order. The expressed logic thus should feel a bit cleaner.\n\nBut how will we actually orchestrate this interaction? First, let's just do it manually, with Promises:\n\n```js\nvar it1 = reqData( \"http://some.url.1\" );\nvar it2 = reqData( \"http://some.url.2\" );\n\nvar p1 = it1.next().value;\nvar p2 = it2.next().value;\n\np1\n.then( function(data){\n\tit1.next( data );\n\treturn p2;\n} )\n.then( function(data){\n\tit2.next( data );\n} );\n```\n\n`*reqData(..)`'s two instances are both started to make their Ajax requests, then paused with `yield`. Then we choose to resume the first instance when `p1` resolves, and then `p2`'s resolution will restart the second instance. In this way, we use Promise orchestration to ensure that `res[0]` will have the first response and `res[1]` will have the second response.\n\nBut frankly, this is awfully manual, and it doesn't really let the generators orchestrate themselves, which is where the true power can lie. Let's try it a different way:\n\n```js\n// `request(..)` is a Promise-aware Ajax utility\n\nvar res = [];\n\nfunction *reqData(url) {\n\tvar data = yield request( url );\n\n\t// transfer control\n\tyield;\n\n\tres.push( data );\n}\n\nvar it1 = reqData( \"http://some.url.1\" );\nvar it2 = reqData( \"http://some.url.2\" );\n\nvar p1 = it1.next().value;\nvar p2 = it2.next().value;\n\np1.then( function(data){\n\tit1.next( data );\n} );\n\np2.then( function(data){\n\tit2.next( data );\n} );\n\nPromise.all( [p1,p2] )\n.then( function(){\n\tit1.next();\n\tit2.next();\n} );\n```\n\nOK, this is a bit better (though still manual!), because now the two instances of `*reqData(..)` run truly concurrently, and (at least for the first part) independently.\n\nIn the previous snippet, the second instance was not given its data until after the first instance was totally finished. But here, both instances receive their data as soon as their respective responses come back, and then each instance does another `yield` for control transfer purposes. We then choose what order to resume them in the `Promise.all([ .. ])` handler.\n\nWhat may not be as obvious is that this approach hints at an easier form for a reusable utility, because of the symmetry. We can do even better. Let's imagine using a utility called `runAll(..)`:\n\n```js\n// `request(..)` is a Promise-aware Ajax utility\n\nvar res = [];\n\nrunAll(\n\tfunction*(){\n\t\tvar p1 = request( \"http://some.url.1\" );\n\n\t\t// transfer control\n\t\tyield;\n\n\t\tres.push( yield p1 );\n\t},\n\tfunction*(){\n\t\tvar p2 = request( \"http://some.url.2\" );\n\n\t\t// transfer control\n\t\tyield;\n\n\t\tres.push( yield p2 );\n\t}\n);\n```\n\n**Note:** We're not including a code listing for `runAll(..)` as it is not only long enough to bog down the text, but is an extension of the logic we've already implemented in `run(..)` earlier. So, as a good supplementary exercise for the reader, try your hand at evolving the code from `run(..)` to work like the imagined `runAll(..)`. Also, my *asynquence* library provides a previously mentioned `runner(..)` utility with this kind of capability already built in, and will be discussed in Appendix A of this book.\n\nHere's how the processing inside `runAll(..)` would operate:\n\n1. The first generator gets a promise for the first Ajax response from `\"http://some.url.1\"`, then `yield`s control back to the `runAll(..)` utility.\n2. The second generator runs and does the same for `\"http://some.url.2\"`, `yield`ing control back to the `runAll(..)` utility.\n3. The first generator resumes, and then `yield`s out its promise `p1`. The `runAll(..)` utility does the same in this case as our previous `run(..)`, in that it waits on that promise to resolve, then resumes the same generator (no control transfer!). When `p1` resolves, `runAll(..)` resumes the first generator again with that resolution value, and then `res[0]` is given its value. When the first generator then finishes, that's an implicit transfer of control.\n4. The second generator resumes, `yield`s out its promise `p2`, and waits for it to resolve. Once it does, `runAll(..)` resumes the second generator with that value, and `res[1]` is set.\n\nIn this running example, we use an outer variable called `res` to store the results of the two different Ajax responses -- that's our concurrency coordination making that possible.\n\nBut it might be quite helpful to further extend `runAll(..)` to provide an inner variable space for the multiple generator instances to *share*, such as an empty object we'll call `data` below. Also, it could take non-Promise values that are `yield`ed and hand them off to the next generator.\n\nConsider:\n\n```js\n// `request(..)` is a Promise-aware Ajax utility\n\nrunAll(\n\tfunction*(data){\n\t\tdata.res = [];\n\n\t\t// transfer control (and message pass)\n\t\tvar url1 = yield \"http://some.url.2\";\n\n\t\tvar p1 = request( url1 ); // \"http://some.url.1\"\n\n\t\t// transfer control\n\t\tyield;\n\n\t\tdata.res.push( yield p1 );\n\t},\n\tfunction*(data){\n\t\t// transfer control (and message pass)\n\t\tvar url2 = yield \"http://some.url.1\";\n\n\t\tvar p2 = request( url2 ); // \"http://some.url.2\"\n\n\t\t// transfer control\n\t\tyield;\n\n\t\tdata.res.push( yield p2 );\n\t}\n);\n```\n\nIn this formulation, the two generators are not just coordinating control transfer, but actually communicating with each other, both through `data.res` and the `yield`ed messages that trade `url1` and `url2` values. That's incredibly powerful!\n\nSuch realization also serves as a conceptual base for a more sophisticated asynchrony technique called CSP (Communicating Sequential Processes), which we will cover in Appendix B of this book.\n\n## Thunks\n\nSo far, we've made the assumption that `yield`ing a Promise from a generator -- and having that Promise resume the generator via a helper utility like `run(..)` -- was the best possible way to manage asynchrony with generators. To be clear, it is.\n\nBut we skipped over another pattern that has some mildly widespread adoption, so in the interest of completeness we'll take a brief look at it.\n\nIn general computer science, there's an old pre-JS concept called a \"thunk.\" Without getting bogged down in the historical nature, a narrow expression of a thunk in JS is a function that -- without any parameters -- is wired to call another function.\n\nIn other words, you wrap a function definition around function call -- with any parameters it needs -- to *defer* the execution of that call, and that wrapping function is a thunk. When you later execute the thunk, you end up calling the original function.\n\nFor example:\n\n```js\nfunction foo(x,y) {\n\treturn x + y;\n}\n\nfunction fooThunk() {\n\treturn foo( 3, 4 );\n}\n\n// later\n\nconsole.log( fooThunk() );\t// 7\n```\n\nSo, a synchronous thunk is pretty straightforward. But what about an async thunk? We can essentially extend the narrow thunk definition to include it receiving a callback.\n\nConsider:\n\n```js\nfunction foo(x,y,cb) {\n\tsetTimeout( function(){\n\t\tcb( x + y );\n\t}, 1000 );\n}\n\nfunction fooThunk(cb) {\n\tfoo( 3, 4, cb );\n}\n\n// later\n\nfooThunk( function(sum){\n\tconsole.log( sum );\t\t// 7\n} );\n```\n\nAs you can see, `fooThunk(..)` only expects a `cb(..)` parameter, as it already has values `3` and `4` (for `x` and `y`, respectively) pre-specified and ready to pass to `foo(..)`. A thunk is just waiting around patiently for the last piece it needs to do its job: the callback.\n\nYou don't want to make thunks manually, though. So, let's invent a utility that does this wrapping for us.\n\nConsider:\n\n```js\nfunction thunkify(fn) {\n\tvar args = [].slice.call( arguments, 1 );\n\treturn function(cb) {\n\t\targs.push( cb );\n\t\treturn fn.apply( null, args );\n\t};\n}\n\nvar fooThunk = thunkify( foo, 3, 4 );\n\n// later\n\nfooThunk( function(sum) {\n\tconsole.log( sum );\t\t// 7\n} );\n```\n\n**Tip:** Here we assume that the original (`foo(..)`) function signature expects its callback in the last position, with any other parameters coming before it. This is a pretty ubiquitous \"standard\" for async JS function standards. You might call it \"callback-last style.\" If for some reason you had a need to handle \"callback-first style\" signatures, you would just make a utility that used `args.unshift(..)` instead of `args.push(..)`.\n\nThe preceding formulation of `thunkify(..)` takes both the `foo(..)` function reference, and any parameters it needs, and returns back the thunk itself (`fooThunk(..)`). However, that's not the typical approach you'll find to thunks in JS.\n\nInstead of `thunkify(..)` making the thunk itself, typically -- if not perplexingly -- the `thunkify(..)` utility would produce a function that produces thunks.\n\nUhhhh... yeah.\n\nConsider:\n\n```js\nfunction thunkify(fn) {\n\treturn function() {\n\t\tvar args = [].slice.call( arguments );\n\t\treturn function(cb) {\n\t\t\targs.push( cb );\n\t\t\treturn fn.apply( null, args );\n\t\t};\n\t};\n}\n```\n\nThe main difference here is the extra `return function() { .. }` layer. Here's how its usage differs:\n\n```js\nvar whatIsThis = thunkify( foo );\n\nvar fooThunk = whatIsThis( 3, 4 );\n\n// later\n\nfooThunk( function(sum) {\n\tconsole.log( sum );\t\t// 7\n} );\n```\n\nObviously, the big question this snippet implies is what is `whatIsThis` properly called? It's not the thunk, it's the thing that will produce thunks from `foo(..)` calls. It's kind of like a \"factory\" for \"thunks.\" There doesn't seem to be any kind of standard agreement for naming such a thing.\n\nSo, my proposal is \"thunkory\" (\"thunk\" + \"factory\"). So, `thunkify(..)` produces a thunkory, and a thunkory produces thunks. That reasoning is symmetric to my proposal for \"promisory\" in Chapter 3:\n\n```js\nvar fooThunkory = thunkify( foo );\n\nvar fooThunk1 = fooThunkory( 3, 4 );\nvar fooThunk2 = fooThunkory( 5, 6 );\n\n// later\n\nfooThunk1( function(sum) {\n\tconsole.log( sum );\t\t// 7\n} );\n\nfooThunk2( function(sum) {\n\tconsole.log( sum );\t\t// 11\n} );\n```\n\n**Note:** The running `foo(..)` example expects a style of callback that's not \"error-first style.\" Of course, \"error-first style\" is much more common. If `foo(..)` had some sort of legitimate error-producing expectation, we could change it to expect and use an error-first callback. None of the subsequent `thunkify(..)` machinery cares what style of callback is assumed. The only difference in usage would be `fooThunk1(function(err,sum){..`.\n\nExposing the thunkory method -- instead of how the earlier `thunkify(..)` hides this intermediary step -- may seem like unnecessary complication. But in general, it's quite useful to make thunkories at the beginning of your program to wrap existing API methods, and then be able to pass around and call those thunkories when you need thunks. The two distinct steps preserve a cleaner separation of capability.\n\nTo illustrate:\n\n```js\n// cleaner:\nvar fooThunkory = thunkify( foo );\n\nvar fooThunk1 = fooThunkory( 3, 4 );\nvar fooThunk2 = fooThunkory( 5, 6 );\n\n// instead of:\nvar fooThunk1 = thunkify( foo, 3, 4 );\nvar fooThunk2 = thunkify( foo, 5, 6 );\n```\n\nRegardless of whether you like to deal with the thunkories explicitly or not, the usage of thunks `fooThunk1(..)` and `fooThunk2(..)` remains the same.\n\n### s/promise/thunk/\n\nSo what's all this thunk stuff have to do with generators?\n\nComparing thunks to promises generally: they're not directly interchangable as they're not equivalent in behavior. Promises are vastly more capable and trustable than bare thunks.\n\nBut in another sense, they both can be seen as a request for a value, which may be async in its answering.\n\nRecall from Chapter 3 we defined a utility for promisifying a function, which we called `Promise.wrap(..)` -- we could have called it `promisify(..)`, too! This Promise-wrapping utility doesn't produce Promises; it produces promisories that in turn produce Promises. This is completely symmetric to the thunkories and thunks presently being discussed.\n\nTo illustrate the symmetry, let's first alter the running `foo(..)` example from earlier to assume an \"error-first style\" callback:\n\n```js\nfunction foo(x,y,cb) {\n\tsetTimeout( function(){\n\t\t// assume `cb(..)` as \"error-first style\"\n\t\tcb( null, x + y );\n\t}, 1000 );\n}\n```\n\nNow, we'll compare using `thunkify(..)` and `promisify(..)` (aka `Promise.wrap(..)` from Chapter 3):\n\n```js\n// symmetrical: constructing the question asker\nvar fooThunkory = thunkify( foo );\nvar fooPromisory = promisify( foo );\n\n// symmetrical: asking the question\nvar fooThunk = fooThunkory( 3, 4 );\nvar fooPromise = fooPromisory( 3, 4 );\n\n// get the thunk answer\nfooThunk( function(err,sum){\n\tif (err) {\n\t\tconsole.error( err );\n\t}\n\telse {\n\t\tconsole.log( sum );\t\t// 7\n\t}\n} );\n\n// get the promise answer\nfooPromise\n.then(\n\tfunction(sum){\n\t\tconsole.log( sum );\t\t// 7\n\t},\n\tfunction(err){\n\t\tconsole.error( err );\n\t}\n);\n```\n\nBoth the thunkory and the promisory are essentially asking a question (for a value), and respectively the thunk `fooThunk` and promise `fooPromise` represent the future answers to that question. Presented in that light, the symmetry is clear.\n\nWith that perspective in mind, we can see that generators which `yield` Promises for asynchrony could instead `yield` thunks for asynchrony. All we'd need is a smarter `run(..)` utility (like from before) that can not only look for and wire up to a `yield`ed Promise but also to provide a callback to a `yield`ed thunk.\n\nConsider:\n\n```js\nfunction *foo() {\n\tvar val = yield request( \"http://some.url.1\" );\n\tconsole.log( val );\n}\n\nrun( foo );\n```\n\nIn this example, `request(..)` could either be a promisory that returns a promise, or a thunkory that returns a thunk. From the perspective of what's going on inside the generator code logic, we don't care about that implementation detail, which is quite powerful!\n\nSo, `request(..)` could be either:\n\n```js\n// promisory `request(..)` (see Chapter 3)\nvar request = Promise.wrap( ajax );\n\n// vs.\n\n// thunkory `request(..)`\nvar request = thunkify( ajax );\n```\n\nFinally, as a thunk-aware patch to our earlier `run(..)` utility, we would need logic like this:\n\n```js\n// ..\n// did we receive a thunk back?\nelse if (typeof next.value == \"function\") {\n\treturn new Promise( function(resolve,reject){\n\t\t// call the thunk with an error-first callback\n\t\tnext.value( function(err,msg) {\n\t\t\tif (err) {\n\t\t\t\treject( err );\n\t\t\t}\n\t\t\telse {\n\t\t\t\tresolve( msg );\n\t\t\t}\n\t\t} );\n\t} )\n\t.then(\n\t\thandleNext,\n\t\tfunction handleErr(err) {\n\t\t\treturn Promise.resolve(\n\t\t\t\tit.throw( err )\n\t\t\t)\n\t\t\t.then( handleResult );\n\t\t}\n\t);\n}\n```\n\nNow, our generators can either call promisories to `yield` Promises, or call thunkories to `yield` thunks, and in either case, `run(..)` would handle that value and use it to wait for the completion to resume the generator.\n\nSymmetry wise, these two approaches look identical. However, we should point out that's true only from the perspective of Promises or thunks representing the future value continuation of a generator.\n\nFrom the larger perspective, thunks do not in and of themselves have hardly any of the trustability or composability guarantees that Promises are designed with. Using a thunk as a stand-in for a Promise in this particular generator asynchrony pattern is workable but should be seen as less than ideal when compared to all the benefits that Promises offer (see Chapter 3).\n\nIf you have the option, prefer `yield pr` rather than `yield th`. But there's nothing wrong with having a `run(..)` utility which can handle both value types.\n\n**Note:** The `runner(..)` utility in my *asynquence* library, which will be discussed in Appendix A, handles `yield`s of Promises, thunks and *asynquence* sequences.\n\n## Pre-ES6 Generators\n\nYou're hopefully convinced now that generators are a very important addition to the async programming toolbox. But it's a new syntax in ES6, which means you can't just polyfill generators like you can Promises (which are just a new API). So what can we do to bring generators to our browser JS if we don't have the luxury of ignoring pre-ES6 browsers?\n\nFor all new syntax extensions in ES6, there are tools -- the most common term for them is transpilers, for trans-compilers -- which can take your ES6 syntax and transform it into equivalent (but obviously uglier!) pre-ES6 code. So, generators can be transpiled into code that will have the same behavior but work in ES5 and below.\n\nBut how? The \"magic\" of `yield` doesn't obviously sound like code that's easy to transpile. We actually hinted at a solution in our earlier discussion of closure-based *iterators*.\n\n### Manual Transformation\n\nBefore we discuss the transpilers, let's derive how manual transpilation would work in the case of generators. This isn't just an academic exercise, because doing so will actually help further reinforce how they work.\n\nConsider:\n\n```js\n// `request(..)` is a Promise-aware Ajax utility\n\nfunction *foo(url) {\n\ttry {\n\t\tconsole.log( \"requesting:\", url );\n\t\tvar val = yield request( url );\n\t\tconsole.log( val );\n\t}\n\tcatch (err) {\n\t\tconsole.log( \"Oops:\", err );\n\t\treturn false;\n\t}\n}\n\nvar it = foo( \"http://some.url.1\" );\n```\n\nThe first thing to observe is that we'll still need a normal `foo()` function that can be called, and it will still need to return an *iterator*. So, let's sketch out the non-generator transformation:\n\n```js\nfunction foo(url) {\n\n\t// ..\n\n\t// make and return an iterator\n\treturn {\n\t\tnext: function(v) {\n\t\t\t// ..\n\t\t},\n\t\tthrow: function(e) {\n\t\t\t// ..\n\t\t}\n\t};\n}\n\nvar it = foo( \"http://some.url.1\" );\n```\n\nThe next thing to observe is that a generator does its \"magic\" by suspending its scope/state, but we can emulate that with function closure (see the *Scope & Closures* title of this series). To understand how to write such code, we'll first annotate different parts of our generator with state values:\n\n```js\n// `request(..)` is a Promise-aware Ajax utility\n\nfunction *foo(url) {\n\t// STATE *1*\n\n\ttry {\n\t\tconsole.log( \"requesting:\", url );\n\t\tvar TMP1 = request( url );\n\n\t\t// STATE *2*\n\t\tvar val = yield TMP1;\n\t\tconsole.log( val );\n\t}\n\tcatch (err) {\n\t\t// STATE *3*\n\t\tconsole.log( \"Oops:\", err );\n\t\treturn false;\n\t}\n}\n```\n\n**Note:** For more accurate illustration, we split up the `val = yield request..` statement into two parts, using the temporary `TMP1` variable. `request(..)` happens in state `*1*`, and the assignment of its completion value to `val` happens in state `*2*`. We'll get rid of that intermediate `TMP1` when we convert the code to its non-generator equivalent.\n\nIn other words, `*1*` is the beginning state, `*2*` is the state if the `request(..)` succeeds, and `*3*` is the state if the `request(..)` fails. You can probably imagine how any extra `yield` steps would just be encoded as extra states.\n\nBack to our transpiled generator, let's define a variable `state` in the closure we can use to keep track of the state:\n\n```js\nfunction foo(url) {\n\t// manage generator state\n\tvar state;\n\n\t// ..\n}\n```\n\nNow, let's define an inner function called `process(..)` inside the closure which handles each state, using a `switch` statement:\n\n```js\n// `request(..)` is a Promise-aware Ajax utility\n\nfunction foo(url) {\n\t// manage generator state\n\tvar state;\n\n\t// generator-wide variable declarations\n\tvar val;\n\n\tfunction process(v) {\n\t\tswitch (state) {\n\t\t\tcase 1:\n\t\t\t\tconsole.log( \"requesting:\", url );\n\t\t\t\treturn request( url );\n\t\t\tcase 2:\n\t\t\t\tval = v;\n\t\t\t\tconsole.log( val );\n\t\t\t\treturn;\n\t\t\tcase 3:\n\t\t\t\tvar err = v;\n\t\t\t\tconsole.log( \"Oops:\", err );\n\t\t\t\treturn false;\n\t\t}\n\t}\n\n\t// ..\n}\n```\n\nEach state in our generator is represented by its own `case` in the `switch` statement. `process(..)` will be called each time we need to process a new state. We'll come back to how that works in just a moment.\n\nFor any generator-wide variable declarations (`val`), we move those to a `var` declaration outside of `process(..)` so they can survive multiple calls to `process(..)`. But the \"block scoped\" `err` variable is only needed for the `*3*` state, so we leave it in place.\n\nIn state `*1*`, instead of `yield request(..)`, we did `return request(..)`. In terminal state `*2*`, there was no explicit `return`, so we just do a `return;` which is the same as `return undefined`. In terminal state `*3*`, there was a `return false`, so we preserve that.\n\nNow we need to define the code in the *iterator* functions so they call `process(..)` appropriately:\n\n```js\nfunction foo(url) {\n\t// manage generator state\n\tvar state;\n\n\t// generator-wide variable declarations\n\tvar val;\n\n\tfunction process(v) {\n\t\tswitch (state) {\n\t\t\tcase 1:\n\t\t\t\tconsole.log( \"requesting:\", url );\n\t\t\t\treturn request( url );\n\t\t\tcase 2:\n\t\t\t\tval = v;\n\t\t\t\tconsole.log( val );\n\t\t\t\treturn;\n\t\t\tcase 3:\n\t\t\t\tvar err = v;\n\t\t\t\tconsole.log( \"Oops:\", err );\n\t\t\t\treturn false;\n\t\t}\n\t}\n\n\t// make and return an iterator\n\treturn {\n\t\tnext: function(v) {\n\t\t\t// initial state\n\t\t\tif (!state) {\n\t\t\t\tstate = 1;\n\t\t\t\treturn {\n\t\t\t\t\tdone: false,\n\t\t\t\t\tvalue: process()\n\t\t\t\t};\n\t\t\t}\n\t\t\t// yield resumed successfully\n\t\t\telse if (state == 1) {\n\t\t\t\tstate = 2;\n\t\t\t\treturn {\n\t\t\t\t\tdone: true,\n\t\t\t\t\tvalue: process( v )\n\t\t\t\t};\n\t\t\t}\n\t\t\t// generator already completed\n\t\t\telse {\n\t\t\t\treturn {\n\t\t\t\t\tdone: true,\n\t\t\t\t\tvalue: undefined\n\t\t\t\t};\n\t\t\t}\n\t\t},\n\t\t\"throw\": function(e) {\n\t\t\t// the only explicit error handling is in\n\t\t\t// state *1*\n\t\t\tif (state == 1) {\n\t\t\t\tstate = 3;\n\t\t\t\treturn {\n\t\t\t\t\tdone: true,\n\t\t\t\t\tvalue: process( e )\n\t\t\t\t};\n\t\t\t}\n\t\t\t// otherwise, an error won't be handled,\n\t\t\t// so just throw it right back out\n\t\t\telse {\n\t\t\t\tthrow e;\n\t\t\t}\n\t\t}\n\t};\n}\n```\n\nHow does this code work?\n\n1. The first call to the *iterator*'s `next()` call would move the generator from the uninitialized state to state `1`, and then call `process()` to handle that state. The return value from `request(..)`, which is the promise for the Ajax response, is returned back as the `value` property from the `next()` call.\n2. If the Ajax request succeeds, the second call to `next(..)` should send in the Ajax response value, which moves our state to `2`. `process(..)` is again called (this time with the passed in Ajax response value), and the `value` property returned from `next(..)` will be `undefined`.\n3. However, if the Ajax request fails, `throw(..)` should be called with the error, which would move the state from `1` to `3` (instead of `2`). Again `process(..)` is called, this time with the error value. That `case` returns `false`, which is set as the `value` property returned from the `throw(..)` call.\n\nFrom the outside -- that is, interacting only with the *iterator* -- this `foo(..)` normal function works pretty much the same as the `*foo(..)` generator would have worked. So we've effectively \"transpiled\" our ES6 generator to pre-ES6 compatibility!\n\nWe could then manually instantiate our generator and control its iterator -- calling `var it = foo(\"..\")` and `it.next(..)` and such -- or better, we could pass it to our previously defined `run(..)` utility as `run(foo,\"..\")`.\n\n### Automatic Transpilation\n\nThe preceding exercise of manually deriving a transformation of our ES6 generator to pre-ES6 equivalent teaches us how generators work conceptually. But that transformation was really intricate and very non-portable to other generators in our code. It would be quite impractical to do this work by hand, and would completely obviate all the benefit of generators.\n\nBut luckily, several tools already exist that can automatically convert ES6 generators to things like what we derived in the previous section. Not only do they do the heavy lifting work for us, but they also handle several complications that we glossed over.\n\nOne such tool is regenerator (https://facebook.github.io/regenerator/), from the smart folks at Facebook.\n\nIf we use regenerator to transpile our previous generator, here's the code produced (at the time of this writing):\n\n```js\n// `request(..)` is a Promise-aware Ajax utility\n\nvar foo = regeneratorRuntime.mark(function foo(url) {\n var val;\n\n return regeneratorRuntime.wrap(function foo$(context$1$0) {\n while (1) switch (context$1$0.prev = context$1$0.next) {\n case 0:\n context$1$0.prev = 0;\n console.log( \"requesting:\", url );\n context$1$0.next = 4;\n return request( url );\n case 4:\n val = context$1$0.sent;\n console.log( val );\n context$1$0.next = 12;\n break;\n case 8:\n context$1$0.prev = 8;\n context$1$0.t0 = context$1$0.catch(0);\n console.log(\"Oops:\", context$1$0.t0);\n return context$1$0.abrupt(\"return\", false);\n case 12:\n case \"end\":\n return context$1$0.stop();\n }\n }, foo, this, [[0, 8]]);\n});\n```\n\nThere's some obvious similarities here to our manual derivation, such as the `switch` / `case` statements, and we even see `val` pulled out of the closure just as we did.\n\nOf course, one trade-off is that regenerator's transpilation requires a helper library `regeneratorRuntime` that holds all the reusable logic for managing a general generator / *iterator*. A lot of that boilerplate looks different than our version, but even then, the concepts can be seen, like with `context$1$0.next = 4` keeping track of the next state for the generator.\n\nThe main takeaway is that generators are not restricted to only being useful in ES6+ environments. Once you understand the concepts, you can employ them throughout your code, and use tools to transform the code to be compatible with older environments.\n\nThis is more work than just using a `Promise` API polyfill for pre-ES6 Promises, but the effort is totally worth it, because generators are so much better at expressing async flow control in a reason-able, sensible, synchronous-looking, sequential fashion.\n\nOnce you get hooked on generators, you'll never want to go back to the hell of async spaghetti callbacks!\n\n## Review\n\nGenerators are a new ES6 function type that does not run-to-completion like normal functions. Instead, the generator can be paused in mid-completion (entirely preserving its state), and it can later be resumed from where it left off.\n\nThis pause/resume interchange is cooperative rather than preemptive, which means that the generator has the sole capability to pause itself, using the `yield` keyword, and yet the *iterator* that controls the generator has the sole capability (via `next(..)`) to resume the generator.\n\nThe `yield` / `next(..)` duality is not just a control mechanism, it's actually a two-way message passing mechanism. A `yield ..` expression essentially pauses waiting for a value, and the next `next(..)` call passes a value (or implicit `undefined`) back to that paused `yield` expression.\n\nThe key benefit of generators related to async flow control is that the code inside a generator expresses a sequence of steps for the task in a naturally sync/sequential fashion. The trick is that we essentially hide potential asynchrony behind the `yield` keyword -- moving the asynchrony to the code where the generator's *iterator* is controlled.\n\nIn other words, generators preserve a sequential, synchronous, blocking code pattern for async code, which lets our brains reason about the code much more naturally, addressing one of the two key drawbacks of callback-based async.\n"
},
{
"path": "async & performance/ch5.md",
"content": "# You Don't Know JS: Async & Performance\n# Глава 5: Производительность программы\n\nДо сих пор эта книга была посвящена тому, как эффективнее использовать паттерны асинхронности. Но мы не рассматривали напрямую, почему асинхронность действительно важна для JS. Самая очевидная и явная причина - это **производительность**.\n\nНапример, если вам нужно выполнить два независимых Ajax-запроса, но вам нужно дождаться их завершения перед выполнением следующей задачи, у вас есть два варианта моделирования этого взаимодействия: последовательный и параллельный.\n\nВы можете сделать первый запрос и ждать начала второго запроса, пока не завершится первый. Или, как мы уже видели на примере обещаний и генераторов, вы можете выполнить оба запроса \"параллельно\" и выразить \"ворота\" для ожидания выполнения обоих запросов, прежде чем двигаться дальше.\n\nОчевидно, что последний вариант, как правило, будет более производительным, чем первый. А лучшая производительность обычно приводит к лучшему пользовательскому опыту\n\nВозможно даже, что асинхронность (чередующийся параллелизм) может улучшить только восприятие производительности, даже если на выполнение программы в целом уходит столько же времени. Восприятие производительности пользователем не менее -- если не более -- важно, чем реальная измеримая производительность.\n\nТеперь мы хотим выйти за рамки локализованных паттернов асинхронности и поговорить о некоторых деталях производительности на уровне программы.\n\n**Примечание:** Вам могут быть интересны вопросы микропроизводительности, например, что быстрее - `a++` или `++a`. Мы рассмотрим такие детали производительности в следующей главе \"Бенчмаркинг и тюнинг\".\n\n## Web Workers\n\nЕсли у вас есть задачи с интенсивной обработкой данных, но вы не хотите, чтобы они выполнялись в главном потоке (что может замедлить работу браузера/интерфейса), вы могли бы пожелать, чтобы JavaScript работал в многопоточном режиме.\n\nВ главе 1 мы подробно рассказывали о том, что JavaScript является однопоточным. И это по-прежнему верно. Но один поток - не единственный способ организовать выполнение программы.\n\nПредставьте, что вы разделили свою программу на две части, запустили одну из них в основном потоке пользовательского интерфейса, а другую - в совершенно отдельном потоке.\n\nКакие проблемы возникнут при такой архитектуре?\n\nНапример, вы бы хотели знать, означает ли выполнение в отдельном потоке, что он работает параллельно (в системах с несколькими процессорами/ядрами), так что долго выполняющийся процесс во втором потоке не будет блокировать основной поток программы. В противном случае \"виртуальные потоки\" не принесут особой пользы по сравнению с тем, что мы уже имеем в JS с асинхронным параллелизмом.\n\nКроме того, вам нужно знать, имеют ли эти две части программы доступ к одной и той же общей области видимости/ресурсам. Если да, то возникают все вопросы, с которыми сталкиваются многопоточные языки (Java, C++ и т. д.), например, необходимость кооперативной или вытесняющей блокировки (мьютексы(взаимное исключение) и т. д.). Это очень много дополнительной работы, и к ней не стоит относиться легкомысленно.\n\nКроме того, вы бы хотели знать, как эти две части могут \"общаться\", если они не могут делиться областью видимости/ресурсами.\n\nВсё это - отличные вопросы для рассмотрения, поскольку мы изучаем функцию, добавленную в веб-платформу примерно во времена HTML5, под названием \"Web Workers\". Это функция браузера (он же хост-окружение), и на самом деле она почти никак не связана с самим языком JS. То есть в JavaScript на данный момент нет никаких функций, поддерживающих многопоточное выполнение.\n\nНо такая среда, как ваш браузер, может легко предоставить несколько экземпляров движка JavaScript, каждый со своим потоком, и позволить вам запускать разные программы в каждом из потоков. Каждый из этих отдельных потоковых частей вашей программы называется \"(Web) Worker\". Такой тип параллелизма называется \"параллелизмом задач (Task parallelism)\", поскольку акцент делается на разделении фрагментов вашей программы для параллельного выполнения.\n\nИз вашей основной JS-программы (или другого Worker) вы создаете Worker следующим образом:\n\n```js\nvar w1 = new Worker( \"http://some.url.1/mycoolworker.js\" );\n```\n\nURL должен указывать на местоположение JS-файла (не HTML-страницы!), который предназначен для загрузки в Worker. После этого браузер запустит отдельный поток и позволит этому файлу выполняться в нем как независимой программе.\n\n**Примечание:** Тип Worker, созданный с помощью такого URL, называется \"Dedicated Worker\". Но вместо URL-адреса внешнего файла вы можете создать \"Inline Worker\", предоставив Blob URL-адрес (еще одна возможность HTML5); по сути, это inline-файл, хранящийся в одном (двоичном) значении. Однако Blob'ы выходят за рамки того, что мы будем обсуждать здесь.\n\nWorkers не имеют общей области видимости или ресурсов друг с другом или с основной программой - это вывело бы на первый план все кошмары многопоточного программирования - но вместо этого их связывает простой механизм обмена сообщениями о событиях.\n\nОбъект `w1` Worker является слушателем событий и триггером, который позволяет вам подписываться на события, посылаемые Worker, а также посылать события Worker.\n\nВот как прослушивать события (если точнее, фиксированное событие `\"message\"`):\n\n```js\nw1.addEventListener( \"message\", function(evt){\n\t// evt.data\n} );\n```\n\nИ вы можете отправить событие `\"message\"` в Worker:\n\n```js\nw1.postMessage( \"something cool to say\" );\n```\n\nВнутри Worker отправка событий полностью симметрична:\n\n```js\n// \"mycoolworker.js\"\n\naddEventListener( \"message\", function(evt){\n\t// evt.data\n} );\n\npostMessage( \"a really cool reply\" );\n```\n\nОбратите внимание, что выделенный Worker находится в отношениях один-к-одному с программой, которая его создала. То есть событие ``message`` не нуждается в устранении неоднозначности, потому что мы уверены, что оно могло произойти только в результате этой связи \"один к одному\" - либо от Worker, либо от главной страницы.\n\nОбычно приложение главной страницы создает Worker'ы, но при необходимости Worker может создавать свои собственные дочерние Worker(ы) - так называемые subworkers. Иногда полезно делегировать такие детали некоему \"главному\" Worker'у, который порождает других Worker'ов для обработки части задачи. К сожалению, на момент написания этой статьи Chrome все еще не поддерживает subworkers, в то время как Firefox поддерживает.\n\nЧтобы немедленно убить Worker из программы, которая его создала, вызовите `terminate()` для объекта Worker (как `w1` в предыдущих сниппетах). Резкое завершение потока Worker не дает ему возможности закончить свою работу или очистить ресурсы. Это похоже на то, как если бы вы закрыли вкладку браузера, чтобы убить страницу.\n\nЕсли в браузере есть две или более страниц (или несколько вкладок с одной и той же страницей!), которые пытаются создать Worker из одного и того же URL-адреса файла, то в итоге они окажутся совершенно отдельными Worker'ами. Вскоре мы обсудим способ \"совместного использования\" Worker'ов.\n\n**Примечание:** Может показаться, что вредоносная или невежественная JS-программа может легко провести атаку на отказ в обслуживании системы (denial-of-service attack), породив сотни Worker'ов, каждый из которых, казалось бы, имеет свой собственный поток. Хотя это правда, что есть некоторая гарантия того, что Worker окажется в отдельном потоке, эта гарантия не безгранична. Система вольна решать, сколько реальных потоков/процессоров/ядер она действительно хочет создать. Невозможно предсказать или гарантировать, к какому количеству потоков вы получите доступ, хотя многие люди полагают, что их будет не меньше, чем количество доступных процессоров/ядер. Я думаю, что самое безопасное предположение - это наличие хотя бы одного другого потока, кроме основного потока пользовательского интерфейса, но это не более того.\n\n### Worker Environment\n\nВнутри Worker у вас нет доступа ни к одному из ресурсов основной программы. Это означает, что вы не можете получить доступ ни к глобальным переменным, ни к DOM страницы, ни к другим ресурсам. Помните: это совершенно отдельный поток.\n\nОднако вы можете выполнять сетевые операции (Ajax, WebSockets) и устанавливать таймеры. Также Worker имеет доступ к собственной копии нескольких важных глобальных переменных/функций, включая `navigator`, `location`, `JSON` и `applicationCache`.\n\nВы также можете загружать в Worker дополнительные JS-скрипты, используя `importScripts(...)`:\n\n```js\n// inside the Worker\nimportScripts( \"foo.js\", \"bar.js\" );\n```\n\nЭти скрипты загружаются синхронно, что означает, что вызов `importScripts(...)` будет блокировать выполнение остальной части Worker'а, пока файл(ы) не закончит(ат) загрузку и выполнение.\n\n**Примечание:** Также обсуждался вопрос о раскрытии API `
![\"Creative](\"https://i.creativecommons.org/l/by-nc-nd/3.0/88x31.png\")
![](\"cover.jpg\")
\n\n-----\n\n**[Купить цифровую или печатную книгу от издательства O'Reilly (англ.)](http://shop.oreilly.com/product/0636920033752.do)**\n\n-----\n\n[Оглавление](toc.md)\n\n* [Введение](foreword.md) (от [Jake Archibald](http://jakearchibald.com))\n* [Предисловие](../preface.md)\n* [Глава 1: Асинхронность: Сейчас и Тогда](ch1.md)\n* [Глава 2: Колбеки](ch2.md)\n* [Глава 3: Обещания](ch3.md)\n* [Глава 4: Генераторы](ch4.md)\n* [Глава 5: Производительность программы](ch5.md)\n* [Глава 6: Бенчмаркинг и настройка](ch6.md)\n* [Приложение A: Библиотека: asynquence](apA.md)\n* [Приложение B: Расширенные асинхронные шаблоны](apB.md)\n* [Приложение C: Благодарности!](apC.md)\n"
},
{
"path": "async & performance/apA.md",
"content": "# You Don't Know JS: Async & Performance\n# Appendix A: *asynquence* Library\n\nChapters 1 and 2 went into quite a bit of detail about typical asynchronous programming patterns and how they're commonly solved with callbacks. But we also saw why callbacks are fatally limited in capability, which led us to Chapters 3 and 4, with Promises and generators offering a much more solid, trustable, and reason-able base to build your asynchrony on.\n\nI referenced my own asynchronous library *asynquence* (http://github.com/getify/asynquence) -- \"async\" + \"sequence\" = \"asynquence\" -- several times in this book, and I want to now briefly explain how it works and why its unique design is important and helpful.\n\nIn the next appendix, we'll explore some advanced async patterns, but you'll probably want a library to make those palatable enough to be useful. We'll use *asynquence* to express those patterns, so you'll want to spend a little time here getting to know the library first.\n\n*asynquence* is obviously not the only option for good async coding; certainly there are many great libraries in this space. But *asynquence* provides a unique perspective by combining the best of all these patterns into a single library, and moreover is built on a single basic abstraction: the (async) sequence.\n\nMy premise is that sophisticated JS programs often need bits and pieces of various different asynchronous patterns woven together, and this is usually left entirely up to each developer to figure out. Instead of having to bring in two or more different async libraries that focus on different aspects of asynchrony, *asynquence* unifies them into variated sequence steps, with just one core library to learn and deploy.\n\nI believe the value is strong enough with *asynquence* to make async flow control programming with Promise-style semantics super easy to accomplish, so that's why we'll exclusively focus on that library here.\n\nTo begin, I'll explain the design principles behind *asynquence*, and then we'll illustrate how its API works with code examples.\n\n## Sequences, Abstraction Design\n\nUnderstanding *asynquence* begins with understanding a fundamental abstraction: any series of steps for a task, whether they separately are synchronous or asynchronous, can be collectively thought of as a \"sequence\". In other words, a sequence is a container that represents a task, and is comprised of individual (potentially async) steps to complete that task.\n\nEach step in the sequence is controlled under the covers by a Promise (see Chapter 3). That is, every step you add to a sequence implicitly creates a Promise that is wired to the previous end of the sequence. Because of the semantics of Promises, every single step advancement in a sequence is asynchronous, even if you synchronously complete the step.\n\nMoreover, a sequence will always proceed linearly from step to step, meaning that step 2 always comes after step 1 finishes, and so on.\n\nOf course, a new sequence can be forked off an existing sequence, meaning the fork only occurs once the main sequence reaches that point in the flow. Sequences can also be combined in various ways, including having one sequence subsumed by another sequence at a particular point in the flow.\n\nA sequence is kind of like a Promise chain. However, with Promise chains, there is no \"handle\" to grab that references the entire chain. Whichever Promise you have a reference to only represents the current step in the chain plus any other steps hanging off it. Essentially, you cannot hold a reference to a Promise chain unless you hold a reference to the first Promise in the chain.\n\nThere are many cases where it turns out to be quite useful to have a handle that references the entire sequence collectively. The most important of those cases is with sequence abort/cancel. As we covered extensively in Chapter 3, Promises themselves should never be able to be canceled, as this violates a fundamental design imperative: external immutability.\n\nBut sequences have no such immutability design principle, mostly because sequences are not passed around as future-value containers that need immutable value semantics. So sequences are the proper level of abstraction to handle abort/cancel behavior. *asynquence* sequences can be `abort()`ed at any time, and the sequence will stop at that point and not go for any reason.\n\nThere's plenty more reasons to prefer a sequence abstraction on top of Promise chains, for flow control purposes.\n\nFirst, Promise chaining is a rather manual process -- one that can get pretty tedious once you start creating and chaining Promises across a wide swath of your programs -- and this tedium can act counterproductively to dissuade the developer from using Promises in places where they are quite appropriate.\n\nAbstractions are meant to reduce boilerplate and tedium, so the sequence abstraction is a good solution to this problem. With Promises, your focus is on the individual step, and there's little assumption that you will keep the chain going. With sequences, the opposite approach is taken, assuming the sequence will keep having more steps added indefinitely.\n\nThis abstraction complexity reduction is especially powerful when you start thinking about higher-order Promise patterns (beyond `race([..])` and `all([..])`.\n\nFor example, in the middle of a sequence, you may want to express a step that is conceptually like a `try..catch` in that the step will always result in success, either the intended main success resolution or a positive nonerror signal for the caught error. Or, you might want to express a step that is like a retry/until loop, where it keeps trying the same step over and over until success occurs.\n\nThese sorts of abstractions are quite nontrivial to express using only Promise primitives, and doing so in the middle of an existing Promise chain is not pretty. But if you abstract your thinking to a sequence, and consider a step as a wrapper around a Promise, that step wrapper can hide such details, freeing you to think about the flow control in the most sensible way without being bothered by the details.\n\nSecond, and perhaps more importantly, thinking of async flow control in terms of steps in a sequence allows you to abstract out the details of what types of asynchronicity are involved with each individual step. Under the covers, a Promise will always control the step, but above the covers, that step can look either like a continuation callback (the simple default), or like a real Promise, or as a run-to-completion generator, or ... Hopefully, you get the picture.\n\nThird, sequences can more easily be twisted to adapt to different modes of thinking, such as event-, stream-, or reactive-based coding. *asynquence* provides a pattern I call \"reactive sequences\" (which we'll cover later) as a variation on the \"reactive observable\" ideas in RxJS (\"Reactive Extensions\"), that lets a repeatable event fire off a new sequence instance each time. Promises are one-shot-only, so it's quite awkward to express repetitious asynchrony with Promises alone.\n\nAnother alternate mode of thinking inverts the resolution/control capability in a pattern I call \"iterable sequences\". Instead of each individual step internally controlling its own completion (and thus advancement of the sequence), the sequence is inverted so the advancement control is through an external iterator, and each step in the *iterable sequence* just responds to the `next(..)` *iterator* control.\n\nWe'll explore all of these different variations as we go throughout the rest of this appendix, so don't worry if we ran over those bits far too quickly just now.\n\nThe takeaway is that sequences are a more powerful and sensible abstraction for complex asynchrony than just Promises (Promise chains) or just generators, and *asynquence* is designed to express that abstraction with just the right level of sugar to make async programming more understandable and more enjoyable.\n\n## *asynquence* API\n\nTo start off, the way you create a sequence (an *asynquence* instance) is with the `ASQ(..)` function. An `ASQ()` call with no parameters creates an empty initial sequence, whereas passing one or more values or functions to `ASQ(..)` sets up the sequence with each argument representing the initial steps of the sequence.\n\n**Note:** For the purposes of all code examples here, I will use the *asynquence* top-level identifier in global browser usage: `ASQ`. If you include and use *asynquence* through a module system (browser or server), you of course can define whichever symbol you prefer, and *asynquence* won't care!\n\nMany of the API methods discussed here are built into the core of *asynquence*, but others are provided through including the optional \"contrib\" plug-ins package. See the documentation for *asynquence* for whether a method is built in or defined via plug-in: http://github.com/getify/asynquence\n\n### Steps\n\nIf a function represents a normal step in the sequence, that function is invoked with the first parameter being the continuation callback, and any subsequent parameters being any messages passed on from the previous step. The step will not complete until the continuation callback is called. Once it's called, any arguments you pass to it will be sent along as messages to the next step in the sequence.\n\nTo add an additional normal step to the sequence, call `then(..)` (which has essentially the exact same semantics as the `ASQ(..)` call):\n\n```js\nASQ(\n\t// step 1\n\tfunction(done){\n\t\tsetTimeout( function(){\n\t\t\tdone( \"Hello\" );\n\t\t}, 100 );\n\t},\n\t// step 2\n\tfunction(done,greeting) {\n\t\tsetTimeout( function(){\n\t\t\tdone( greeting + \" World\" );\n\t\t}, 100 );\n\t}\n)\n// step 3\n.then( function(done,msg){\n\tsetTimeout( function(){\n\t\tdone( msg.toUpperCase() );\n\t}, 100 );\n} )\n// step 4\n.then( function(done,msg){\n\tconsole.log( msg );\t\t\t// HELLO WORLD\n} );\n```\n\n**Note:** Though the name `then(..)` is identical to the native Promises API, this `then(..)` is different. You can pass as few or as many functions or values to `then(..)` as you'd like, and each is taken as a separate step. There's no two-callback fulfilled/rejected semantics involved.\n\nUnlike with Promises, where to chain one Promise to the next you have to create and `return` that Promise from a `then(..)` fulfillment handler, with *asynquence*, all you need to do is call the continuation callback -- I always call it `done()` but you can name it whatever suits you -- and optionally pass it completion messages as arguments.\n\nEach step defined by `then(..)` is assumed to be asynchronous. If you have a step that's synchronous, you can either just call `done(..)` right away, or you can use the simpler `val(..)` step helper:\n\n```js\n// step 1 (sync)\nASQ( function(done){\n\tdone( \"Hello\" );\t// manually synchronous\n} )\n// step 2 (sync)\n.val( function(greeting){\n\treturn greeting + \" World\";\n} )\n// step 3 (async)\n.then( function(done,msg){\n\tsetTimeout( function(){\n\t\tdone( msg.toUpperCase() );\n\t}, 100 );\n} )\n// step 4 (sync)\n.val( function(msg){\n\tconsole.log( msg );\n} );\n```\n\nAs you can see, `val(..)`-invoked steps don't receive a continuation callback, as that part is assumed for you -- and the parameter list is less cluttered as a result! To send a message along to the next step, you simply use `return`.\n\nThink of `val(..)` as representing a synchronous \"value-only\" step, which is useful for synchronous value operations, logging, and the like.\n\n### Errors\n\nOne important difference with *asynquence* compared to Promises is with error handling.\n\nWith Promises, each individual Promise (step) in a chain can have its own independent error, and each subsequent step has the ability to handle the error or not. The main reason for this semantic comes (again) from the focus on individual Promises rather than on the chain (sequence) as a whole.\n\nI believe that most of the time, an error in one part of a sequence is generally not recoverable, so the subsequent steps in the sequence are moot and should be skipped. So, by default, an error at any step of a sequence throws the entire sequence into error mode, and the rest of the normal steps are ignored.\n\nIf you *do* need to have a step where its error is recoverable, there are several different API methods that can accommodate, such as `try(..)` -- previously mentioned as a kind of `try..catch` step -- or `until(..)` -- a retry loop that keeps attempting the step until it succeeds or you manually `break()` the loop. *asynquence* even has `pThen(..)` and `pCatch(..)` methods, which work identically to how normal Promise `then(..)` and `catch(..)` work (see Chapter 3), so you can do localized mid-sequence error handling if you so choose.\n\nThe point is, you have both options, but the more common one in my experience is the default. With Promises, to get a chain of steps to ignore all steps once an error occurs, you have to take care not to register a rejection handler at any step; otherwise, that error gets swallowed as handled, and the sequence may continue (perhaps unexpectedly). This kind of desired behavior is a bit awkward to properly and reliably handle.\n\nTo register a sequence error notification handler, *asynquence* provides an `or(..)` sequence method, which also has an alias of `onerror(..)`. You can call this method anywhere in the sequence, and you can register as many handlers as you'd like. That makes it easy for multiple different consumers to listen in on a sequence to know if it failed or not; it's kind of like an error event handler in that respect.\n\nJust like with Promises, all JS exceptions become sequence errors, or you can programmatically signal a sequence error:\n\n```js\nvar sq = ASQ( function(done){\n\tsetTimeout( function(){\n\t\t// signal an error for the sequence\n\t\tdone.fail( \"Oops\" );\n\t}, 100 );\n} )\n.then( function(done){\n\t// will never get here\n} )\n.or( function(err){\n\tconsole.log( err );\t\t\t// Oops\n} )\n.then( function(done){\n\t// won't get here either\n} );\n\n// later\n\nsq.or( function(err){\n\tconsole.log( err );\t\t\t// Oops\n} );\n```\n\nAnother really important difference with error handling in *asynquence* compared to native Promises is the default behavior of \"unhandled exceptions\". As we discussed at length in Chapter 3, a rejected Promise without a registered rejection handler will just silently hold (aka swallow) the error; you have to remember to always end a chain with a final `catch(..)`.\n\nIn *asynquence*, the assumption is reversed.\n\nIf an error occurs on a sequence, and it **at that moment** has no error handlers registered, the error is reported to the `console`. In other words, unhandled rejections are by default always reported so as not to be swallowed and missed.\n\nAs soon as you register an error handler against a sequence, it opts that sequence out of such reporting, to prevent duplicate noise.\n\nThere may, in fact, be cases where you want to create a sequence that may go into the error state before you have a chance to register the handler. This isn't common, but it can happen from time to time.\n\nIn those cases, you can also **opt a sequence instance out** of error reporting by calling `defer()` on the sequence. You should only opt out of error reporting if you are sure that you're going to eventually handle such errors:\n\n```js\nvar sq1 = ASQ( function(done){\n\tdoesnt.Exist();\t\t\t// will throw exception to console\n} );\n\nvar sq2 = ASQ( function(done){\n\tdoesnt.Exist();\t\t\t// will throw only a sequence error\n} )\n// opt-out of error reporting\n.defer();\n\nsetTimeout( function(){\n\tsq1.or( function(err){\n\t\tconsole.log( err );\t// ReferenceError\n\t} );\n\n\tsq2.or( function(err){\n\t\tconsole.log( err );\t// ReferenceError\n\t} );\n}, 100 );\n\n// ReferenceError (from sq1)\n```\n\nThis is better error handling behavior than Promises themselves have, because it's the Pit of Success, not the Pit of Failure (see Chapter 3).\n\n**Note:** If a sequence is piped into (aka subsumed by) another sequence -- see \"Combining Sequences\" for a complete description -- then the source sequence is opted out of error reporting, but now the target sequence's error reporting or lack thereof must be considered.\n\n### Parallel Steps\n\nNot all steps in your sequences will have just a single (async) task to perform; some will need to perform multiple steps \"in parallel\" (concurrently). A step in a sequence in which multiple substeps are processing concurrently is called a `gate(..)` -- there's an `all(..)` alias if you prefer -- and is directly symmetric to native `Promise.all([..])`.\n\nIf all the steps in the `gate(..)` complete successfully, all success messages will be passed to the next sequence step. If any of them generate errors, the whole sequence immediately goes into an error state.\n\nConsider:\n\n```js\nASQ( function(done){\n\tsetTimeout( done, 100 );\n} )\n.gate(\n\tfunction(done){\n\t\tsetTimeout( function(){\n\t\t\tdone( \"Hello\" );\n\t\t}, 100 );\n\t},\n\tfunction(done){\n\t\tsetTimeout( function(){\n\t\t\tdone( \"World\", \"!\" );\n\t\t}, 100 );\n\t}\n)\n.val( function(msg1,msg2){\n\tconsole.log( msg1 );\t// Hello\n\tconsole.log( msg2 );\t// [ \"World\", \"!\" ]\n} );\n```\n\nFor illustration, let's compare that example to native Promises:\n\n```js\nnew Promise( function(resolve,reject){\n\tsetTimeout( resolve, 100 );\n} )\n.then( function(){\n\treturn Promise.all( [\n\t\tnew Promise( function(resolve,reject){\n\t\t\tsetTimeout( function(){\n\t\t\t\tresolve( \"Hello\" );\n\t\t\t}, 100 );\n\t\t} ),\n\t\tnew Promise( function(resolve,reject){\n\t\t\tsetTimeout( function(){\n\t\t\t\t// note: we need a [ ] array here\n\t\t\t\tresolve( [ \"World\", \"!\" ] );\n\t\t\t}, 100 );\n\t\t} )\n\t] );\n} )\n.then( function(msgs){\n\tconsole.log( msgs[0] );\t// Hello\n\tconsole.log( msgs[1] );\t// [ \"World\", \"!\" ]\n} );\n```\n\nYuck. Promises require a lot more boilerplate overhead to express the same asynchronous flow control. That's a great illustration of why the *asynquence* API and abstraction make dealing with Promise steps a lot nicer. The improvement only goes higher the more complex your asynchrony is.\n\n#### Step Variations\n\nThere are several variations in the contrib plug-ins on *asynquence*'s `gate(..)` step type that can be quite helpful:\n\n* `any(..)` is like `gate(..)`, except just one segment has to eventually succeed to proceed on the main sequence.\n* `first(..)` is like `any(..)`, except as soon as any segment succeeds, the main sequence proceeds (ignoring subsequent results from other segments).\n* `race(..)` (symmetric with `Promise.race([..])`) is like `first(..)`, except the main sequence proceeds as soon as any segment completes (either success or failure).\n* `last(..)` is like `any(..)`, except only the latest segment to complete successfully sends its message(s) along to the main sequence.\n* `none(..)` is the inverse of `gate(..)`: the main sequence proceeds only if all the segments fail (with all segment error message(s) transposed as success message(s) and vice versa).\n\nLet's first define some helpers to make illustration cleaner:\n\n```js\nfunction success1(done) {\n\tsetTimeout( function(){\n\t\tdone( 1 );\n\t}, 100 );\n}\n\nfunction success2(done) {\n\tsetTimeout( function(){\n\t\tdone( 2 );\n\t}, 100 );\n}\n\nfunction failure3(done) {\n\tsetTimeout( function(){\n\t\tdone.fail( 3 );\n\t}, 100 );\n}\n\nfunction output(msg) {\n\tconsole.log( msg );\n}\n```\n\nNow, let's demonstrate these `gate(..)` step variations:\n\n```js\nASQ().race(\n\tfailure3,\n\tsuccess1\n)\n.or( output );\t\t// 3\n\n\nASQ().any(\n\tsuccess1,\n\tfailure3,\n\tsuccess2\n)\n.val( function(){\n\tvar args = [].slice.call( arguments );\n\tconsole.log(\n\t\targs\t\t// [ 1, undefined, 2 ]\n\t);\n} );\n\n\nASQ().first(\n\tfailure3,\n\tsuccess1,\n\tsuccess2\n)\n.val( output );\t\t// 1\n\n\nASQ().last(\n\tfailure3,\n\tsuccess1,\n\tsuccess2\n)\n.val( output );\t\t// 2\n\nASQ().none(\n\tfailure3\n)\n.val( output )\t\t// 3\n.none(\n\tfailure3\n\tsuccess1\n)\n.or( output );\t\t// 1\n```\n\nAnother step variation is `map(..)`, which lets you asynchronously map elements of an array to different values, and the step doesn't proceed until all the mappings are complete. `map(..)` is very similar to `gate(..)`, except it gets the initial values from an array instead of from separately specified functions, and also because you define a single function callback to operate on each value:\n\n```js\nfunction double(x,done) {\n\tsetTimeout( function(){\n\t\tdone( x * 2 );\n\t}, 100 );\n}\n\nASQ().map( [1,2,3], double )\n.val( output );\t\t\t\t\t// [2,4,6]\n```\n\nAlso, `map(..)` can receive either of its parameters (the array or the callback) from messages passed from the previous step:\n\n```js\nfunction plusOne(x,done) {\n\tsetTimeout( function(){\n\t\tdone( x + 1 );\n\t}, 100 );\n}\n\nASQ( [1,2,3] )\n.map( double )\t\t\t// message `[1,2,3]` comes in\n.map( plusOne )\t\t\t// message `[2,4,6]` comes in\n.val( output );\t\t\t// [3,5,7]\n```\n\nAnother variation is `waterfall(..)`, which is kind of like a mixture between `gate(..)`'s message collection behavior but `then(..)`'s sequential processing.\n\nStep 1 is first executed, then the success message from step 1 is given to step 2, and then both success messages go to step 3, and then all three success messages go to step 4, and so on, such that the messages sort of collect and cascade down the \"waterfall\".\n\nConsider:\n\n```js\nfunction double(done) {\n\tvar args = [].slice.call( arguments, 1 );\n\tconsole.log( args );\n\n\tsetTimeout( function(){\n\t\tdone( args[args.length - 1] * 2 );\n\t}, 100 );\n}\n\nASQ( 3 )\n.waterfall(\n\tdouble,\t\t\t\t\t// [ 3 ]\n\tdouble,\t\t\t\t\t// [ 6 ]\n\tdouble,\t\t\t\t\t// [ 6, 12 ]\n\tdouble\t\t\t\t\t// [ 6, 12, 24 ]\n)\n.val( function(){\n\tvar args = [].slice.call( arguments );\n\tconsole.log( args );\t// [ 6, 12, 24, 48 ]\n} );\n```\n\nIf at any point in the \"waterfall\" an error occurs, the whole sequence immediately goes into an error state.\n\n#### Error Tolerance\n\nSometimes you want to manage errors at the step level and not let them necessarily send the whole sequence into the error state. *asynquence* offers two step variations for that purpose.\n\n`try(..)` attempts a step, and if it succeeds, the sequence proceeds as normal, but if the step fails, the failure is turned into a success message formated as `{ catch: .. }` with the error message(s) filled in:\n\n```js\nASQ()\n.try( success1 )\n.val( output )\t\t\t// 1\n.try( failure3 )\n.val( output )\t\t\t// { catch: 3 }\n.or( function(err){\n\t// never gets here\n} );\n```\n\nYou could instead set up a retry loop using `until(..)`, which tries the step and if it fails, retries the step again on the next event loop tick, and so on.\n\nThis retry loop can continue indefinitely, but if you want to break out of the loop, you can call the `break()` flag on the completion trigger, which sends the main sequence into an error state:\n\n```js\nvar count = 0;\n\nASQ( 3 )\n.until( double )\n.val( output )\t\t\t\t\t// 6\n.until( function(done){\n\tcount++;\n\n\tsetTimeout( function(){\n\t\tif (count < 5) {\n\t\t\tdone.fail();\n\t\t}\n\t\telse {\n\t\t\t// break out of the `until(..)` retry loop\n\t\t\tdone.break( \"Oops\" );\n\t\t}\n\t}, 100 );\n} )\n.or( output );\t\t\t\t\t// Oops\n```\n\n#### Promise-Style Steps\n\nIf you would prefer to have, inline in your sequence, Promise-style semantics like Promises' `then(..)` and `catch(..)` (see Chapter 3), you can use the `pThen` and `pCatch` plug-ins:\n\n```js\nASQ( 21 )\n.pThen( function(msg){\n\treturn msg * 2;\n} )\n.pThen( output )\t\t\t\t// 42\n.pThen( function(){\n\t// throw an exception\n\tdoesnt.Exist();\n} )\n.pCatch( function(err){\n\t// caught the exception (rejection)\n\tconsole.log( err );\t\t\t// ReferenceError\n} )\n.val( function(){\n\t// main sequence is back in a\n\t// success state because previous\n\t// exception was caught by\n\t// `pCatch(..)`\n} );\n```\n\n`pThen(..)` and `pCatch(..)` are designed to run in the sequence, but behave as if it was a normal Promise chain. As such, you can either resolve genuine Promises or *asynquence* sequences from the \"fulfillment\" handler passed to `pThen(..)` (see Chapter 3).\n\n### Forking Sequences\n\nOne feature that can be quite useful about Promises is that you can attach multiple `then(..)` handler registrations to the same promise, effectively \"forking\" the flow-control at that promise:\n\n```js\nvar p = Promise.resolve( 21 );\n\n// fork 1 (from `p`)\np.then( function(msg){\n\treturn msg * 2;\n} )\n.then( function(msg){\n\tconsole.log( msg );\t\t// 42\n} )\n\n// fork 2 (from `p`)\np.then( function(msg){\n\tconsole.log( msg );\t\t// 21\n} );\n```\n\nThe same \"forking\" is easy in *asynquence* with `fork()`:\n\n```js\nvar sq = ASQ(..).then(..).then(..);\n\nvar sq2 = sq.fork();\n\n// fork 1\nsq.then(..)..;\n\n// fork 2\nsq2.then(..)..;\n```\n\n### Combining Sequences\n\nThe reverse of `fork()`ing, you can combine two sequences by subsuming one into another, using the `seq(..)` instance method:\n\n```js\nvar sq = ASQ( function(done){\n\tsetTimeout( function(){\n\t\tdone( \"Hello World\" );\n\t}, 200 );\n} );\n\nASQ( function(done){\n\tsetTimeout( done, 100 );\n} )\n// subsume `sq` sequence into this sequence\n.seq( sq )\n.val( function(msg){\n\tconsole.log( msg );\t\t// Hello World\n} )\n```\n\n`seq(..)` can either accept a sequence itself, as shown here, or a function. If a function, it's expected that the function when called will return a sequence, so the preceding code could have been done with:\n\n```js\n// ..\n.seq( function(){\n\treturn sq;\n} )\n// ..\n```\n\nAlso, that step could instead have been accomplished with a `pipe(..)`:\n\n```js\n// ..\n.then( function(done){\n\t// pipe `sq` into the `done` continuation callback\n\tsq.pipe( done );\n} )\n// ..\n```\n\nWhen a sequence is subsumed, both its success message stream and its error stream are piped in.\n\n**Note:** As mentioned in an earlier note, piping (manually with `pipe(..)` or automatically with `seq(..)`) opts the source sequence out of error-reporting, but doesn't affect the error reporting status of the target sequence.\n\n## Value and Error Sequences\n\nIf any step of a sequence is just a normal value, that value is just mapped to that step's completion message:\n\n```js\nvar sq = ASQ( 42 );\n\nsq.val( function(msg){\n\tconsole.log( msg );\t\t// 42\n} );\n```\n\nIf you want to make a sequence that's automatically errored:\n\n```js\nvar sq = ASQ.failed( \"Oops\" );\n\nASQ()\n.seq( sq )\n.val( function(msg){\n\t// won't get here\n} )\n.or( function(err){\n\tconsole.log( err );\t\t// Oops\n} );\n```\n\nYou also may want to automatically create a delayed-value or a delayed-error sequence. Using the `after` and `failAfter` contrib plug-ins, this is easy:\n\n```js\nvar sq1 = ASQ.after( 100, \"Hello\", \"World\" );\nvar sq2 = ASQ.failAfter( 100, \"Oops\" );\n\nsq1.val( function(msg1,msg2){\n\tconsole.log( msg1, msg2 );\t\t// Hello World\n} );\n\nsq2.or( function(err){\n\tconsole.log( err );\t\t\t\t// Oops\n} );\n```\n\nYou can also insert a delay in the middle of a sequence using `after(..)`:\n\n```js\nASQ( 42 )\n// insert a delay into the sequence\n.after( 100 )\n.val( function(msg){\n\tconsole.log( msg );\t\t// 42\n} );\n```\n\n## Promises and Callbacks\n\nI think *asynquence* sequences provide a lot of value on top of native Promises, and for the most part you'll find it more pleasant and more powerful to work at that level of abstraction. However, integrating *asynquence* with other non-*asynquence* code will be a reality.\n\nYou can easily subsume a promise (e.g., thenable -- see Chapter 3) into a sequence using the `promise(..)` instance method:\n\n```js\nvar p = Promise.resolve( 42 );\n\nASQ()\n.promise( p )\t\t\t// could also: `function(){ return p; }`\n.val( function(msg){\n\tconsole.log( msg );\t// 42\n} );\n```\n\nAnd to go the opposite direction and fork/vend a promise from a sequence at a certain step, use the `toPromise` contrib plug-in:\n\n```js\nvar sq = ASQ.after( 100, \"Hello World\" );\n\nsq.toPromise()\n// this is a standard promise chain now\n.then( function(msg){\n\treturn msg.toUpperCase();\n} )\n.then( function(msg){\n\tconsole.log( msg );\t\t// HELLO WORLD\n} );\n```\n\nTo adapt *asynquence* to systems using callbacks, there are several helper facilities. To automatically generate an \"error-first style\" callback from your sequence to wire into a callback-oriented utility, use `errfcb`:\n\n```js\nvar sq = ASQ( function(done){\n\t// note: expecting \"error-first style\" callback\n\tsomeAsyncFuncWithCB( 1, 2, done.errfcb )\n} )\n.val( function(msg){\n\t// ..\n} )\n.or( function(err){\n\t// ..\n} );\n\n// note: expecting \"error-first style\" callback\nanotherAsyncFuncWithCB( 1, 2, sq.errfcb() );\n```\n\nYou also may want to create a sequence-wrapped version of a utility -- compare to \"promisory\" in Chapter 3 and \"thunkory\" in Chapter 4 -- and *asynquence* provides `ASQ.wrap(..)` for that purpose:\n\n```js\nvar coolUtility = ASQ.wrap( someAsyncFuncWithCB );\n\ncoolUtility( 1, 2 )\n.val( function(msg){\n\t// ..\n} )\n.or( function(err){\n\t// ..\n} );\n```\n\n**Note:** For the sake of clarity (and for fun!), let's coin yet another term, for a sequence-producing function that comes from `ASQ.wrap(..)`, like `coolUtility` here. I propose \"sequory\" (\"sequence\" + \"factory\").\n\n## Iterable Sequences\n\nThe normal paradigm for a sequence is that each step is responsible for completing itself, which is what advances the sequence. Promises work the same way.\n\nThe unfortunate part is that sometimes you need external control over a Promise/step, which leads to awkward \"capability extraction\".\n\nConsider this Promises example:\n\n```js\nvar domready = new Promise( function(resolve,reject){\n\t// don't want to put this here, because\n\t// it belongs logically in another part\n\t// of the code\n\tdocument.addEventListener( \"DOMContentLoaded\", resolve );\n} );\n\n// ..\n\ndomready.then( function(){\n\t// DOM is ready!\n} );\n```\n\nThe \"capability extraction\" anti-pattern with Promises looks like this:\n\n```js\nvar ready;\n\nvar domready = new Promise( function(resolve,reject){\n\t// extract the `resolve()` capability\n\tready = resolve;\n} );\n\n// ..\n\ndomready.then( function(){\n\t// DOM is ready!\n} );\n\n// ..\n\ndocument.addEventListener( \"DOMContentLoaded\", ready );\n```\n\n**Note:** This anti-pattern is an awkward code smell, in my opinion, but some developers like it, for reasons I can't grasp.\n\n*asynquence* offers an inverted sequence type I call \"iterable sequences\", which externalizes the control capability (it's quite useful in use cases like the `domready`):\n\n```js\n// note: `domready` here is an *iterator* that\n// controls the sequence\nvar domready = ASQ.iterable();\n\n// ..\n\ndomready.val( function(){\n\t// DOM is ready\n} );\n\n// ..\n\ndocument.addEventListener( \"DOMContentLoaded\", domready.next );\n```\n\nThere's more to iterable sequences than what we see in this scenario. We'll come back to them in Appendix B.\n\n## Running Generators\n\nIn Chapter 4, we derived a utility called `run(..)` which can run generators to completion, listening for `yield`ed Promises and using them to async resume the generator. *asynquence* has just such a utility built in, called `runner(..)`.\n\nLet's first set up some helpers for illustration:\n\n```js\nfunction doublePr(x) {\n\treturn new Promise( function(resolve,reject){\n\t\tsetTimeout( function(){\n\t\t\tresolve( x * 2 );\n\t\t}, 100 );\n\t} );\n}\n\nfunction doubleSeq(x) {\n\treturn ASQ( function(done){\n\t\tsetTimeout( function(){\n\t\t\tdone( x * 2)\n\t\t}, 100 );\n\t} );\n}\n```\n\nNow, we can use `runner(..)` as a step in the middle of a sequence:\n\n```js\nASQ( 10, 11 )\n.runner( function*(token){\n\tvar x = token.messages[0] + token.messages[1];\n\n\t// yield a real promise\n\tx = yield doublePr( x );\n\n\t// yield a sequence\n\tx = yield doubleSeq( x );\n\n\treturn x;\n} )\n.val( function(msg){\n\tconsole.log( msg );\t\t\t// 84\n} );\n```\n\n### Wrapped Generators\n\nYou can also create a self-packaged generator -- that is, a normal function that runs your specified generator and returns a sequence for its completion -- by `ASQ.wrap(..)`ing it:\n\n```js\nvar foo = ASQ.wrap( function*(token){\n\tvar x = token.messages[0] + token.messages[1];\n\n\t// yield a real promise\n\tx = yield doublePr( x );\n\n\t// yield a sequence\n\tx = yield doubleSeq( x );\n\n\treturn x;\n}, { gen: true } );\n\n// ..\n\nfoo( 8, 9 )\n.val( function(msg){\n\tconsole.log( msg );\t\t\t// 68\n} );\n```\n\nThere's a lot more awesome that `runner(..)` is capable of, but we'll come back to that in Appendix B.\n\n## Review\n\n*asynquence* is a simple abstraction -- a sequence is a series of (async) steps -- on top of Promises, aimed at making working with various asynchronous patterns much easier, without any compromise in capability.\n\nThere are other goodies in the *asynquence* core API and its contrib plug-ins beyond what we saw in this appendix, but we'll leave that as an exercise for the reader to go check the rest of the capabilities out.\n\nYou've now seen the essence and spirit of *asynquence*. The key take away is that a sequence is comprised of steps, and those steps can be any of dozens of different variations on Promises, or they can be a generator-run, or... The choice is up to you, you have all the freedom to weave together whatever async flow control logic is appropriate for your tasks. No more library switching to catch different async patterns.\n\nIf these *asynquence* snippets have made sense to you, you're now pretty well up to speed on the library; it doesn't take that much to learn, actually!\n\nIf you're still a little fuzzy on how it works (or why!), you'll want to spend a little more time examining the previous examples and playing around with *asynquence* yourself, before going on to the next appendix. Appendix B will push *asynquence* into several more advanced and powerful async patterns.\n"
},
{
"path": "async & performance/apB.md",
"content": "# You Don't Know JS: Async & Performance\n# Appendix B: Advanced Async Patterns\n\nAppendix A introduced the *asynquence* library for sequence-oriented async flow control, primarily based on Promises and generators.\n\nNow we'll explore other advanced asynchronous patterns built on top of that existing understanding and functionality, and see how *asynquence* makes those sophisticated async techniques easy to mix and match in our programs without needing lots of separate libraries.\n\n## Iterable Sequences\n\nWe introduced *asynquence*'s iterable sequences in the previous appendix, but we want to revisit them in more detail.\n\nTo refresh, recall:\n\n```js\nvar domready = ASQ.iterable();\n\n// ..\n\ndomready.val( function(){\n\t// DOM is ready\n} );\n\n// ..\n\ndocument.addEventListener( \"DOMContentLoaded\", domready.next );\n```\n\nNow, let's define a sequence of multiple steps as an iterable sequence:\n\n```js\nvar steps = ASQ.iterable();\n\nsteps\n.then( function STEP1(x){\n\treturn x * 2;\n} )\n.steps( function STEP2(x){\n\treturn x + 3;\n} )\n.steps( function STEP3(x){\n\treturn x * 4;\n} );\n\nsteps.next( 8 ).value;\t// 16\nsteps.next( 16 ).value;\t// 19\nsteps.next( 19 ).value;\t// 76\nsteps.next().done;\t\t// true\n```\n\nAs you can see, an iterable sequence is a standard-compliant *iterator* (see Chapter 4). So, it can be iterated with an ES6 `for..of` loop, just like a generator (or any other *iterable*) can:\n\n```js\nvar steps = ASQ.iterable();\n\nsteps\n.then( function STEP1(){ return 2; } )\n.then( function STEP2(){ return 4; } )\n.then( function STEP3(){ return 6; } )\n.then( function STEP4(){ return 8; } )\n.then( function STEP5(){ return 10; } );\n\nfor (var v of steps) {\n\tconsole.log( v );\n}\n// 2 4 6 8 10\n```\n\nBeyond the event triggering example shown in the previous appendix, iterable sequences are interesting because in essence they can be seen as a stand-in for generators or Promise chains, but with even more flexibility.\n\nConsider a multiple Ajax request example -- we've seen the same scenario in Chapters 3 and 4, both as a Promise chain and as a generator, respectively -- expressed as an iterable sequence:\n\n```js\n// sequence-aware ajax\nvar request = ASQ.wrap( ajax );\n\nASQ( \"http://some.url.1\" )\n.runner(\n\tASQ.iterable()\n\n\t.then( function STEP1(token){\n\t\tvar url = token.messages[0];\n\t\treturn request( url );\n\t} )\n\n\t.then( function STEP2(resp){\n\t\treturn ASQ().gate(\n\t\t\trequest( \"http://some.url.2/?v=\" + resp ),\n\t\t\trequest( \"http://some.url.3/?v=\" + resp )\n\t\t);\n\t} )\n\n\t.then( function STEP3(r1,r2){ return r1 + r2; } )\n)\n.val( function(msg){\n\tconsole.log( msg );\n} );\n```\n\nThe iterable sequence expresses a sequential series of (sync or async) steps that looks awfully similar to a Promise chain -- in other words, it's much cleaner looking than just plain nested callbacks, but not quite as nice as the `yield`-based sequential syntax of generators.\n\nBut we pass the iterable sequence into `ASQ#runner(..)`, which runs it to completion the same as if it was a generator. The fact that an iterable sequence behaves essentially the same as a generator is notable for a couple of reasons.\n\nFirst, iterable sequences are kind of a pre-ES6 equivalent to a certain subset of ES6 generators, which means you can either author them directly (to run anywhere), or you can author ES6 generators and transpile/convert them to iterable sequences (or Promise chains for that matter!).\n\nThinking of an async-run-to-completion generator as just syntactic sugar for a Promise chain is an important recognition of their isomorphic relationship.\n\nBefore we move on, we should note that the previous snippet could have been expressed in *asynquence* as:\n\n```js\nASQ( \"http://some.url.1\" )\n.seq( /*STEP 1*/ request )\n.seq( function STEP2(resp){\n\treturn ASQ().gate(\n\t\trequest( \"http://some.url.2/?v=\" + resp ),\n\t\trequest( \"http://some.url.3/?v=\" + resp )\n\t);\n} )\n.val( function STEP3(r1,r2){ return r1 + r2; } )\n.val( function(msg){\n\tconsole.log( msg );\n} );\n```\n\nMoreover, step 2 could have even been expressed as:\n\n```js\n.gate(\n\tfunction STEP2a(done,resp) {\n\t\trequest( \"http://some.url.2/?v=\" + resp )\n\t\t.pipe( done );\n\t},\n\tfunction STEP2b(done,resp) {\n\t\trequest( \"http://some.url.3/?v=\" + resp )\n\t\t.pipe( done );\n\t}\n)\n```\n\nSo, why would we go to the trouble of expressing our flow control as an iterable sequence in a `ASQ#runner(..)` step, when it seems like a simpler/flatter *asyquence* chain does the job well?\n\nBecause the iterable sequence form has an important trick up its sleeve that gives us more capability. Read on.\n\n### Extending Iterable Sequences\n\nGenerators, normal *asynquence* sequences, and Promise chains, are all **eagerly evaluated** -- whatever flow control is expressed initially *is* the fixed flow that will be followed.\n\nHowever, iterable sequences are **lazily evaluated**, which means that during execution of the iterable sequence, you can extend the sequence with more steps if desired.\n\n**Note:** You can only append to the end of an iterable sequence, not inject into the middle of the sequence.\n\nLet's first look at a simpler (synchronous) example of that capability to get familiar with it:\n\n```js\nfunction double(x) {\n\tx *= 2;\n\n\t// should we keep extending?\n\tif (x < 500) {\n\t\tisq.then( double );\n\t}\n\n\treturn x;\n}\n\n// setup single-step iterable sequence\nvar isq = ASQ.iterable().then( double );\n\nfor (var v = 10, ret;\n\t(ret = isq.next( v )) && !ret.done;\n) {\n\tv = ret.value;\n\tconsole.log( v );\n}\n```\n\nThe iterable sequence starts out with only one defined step (`isq.then(double)`), but the sequence keeps extending itself under certain conditions (`x < 500`). Both *asynquence* sequences and Promise chains technically *can* do something similar, but we'll see in a little bit why their capability is insufficient.\n\nThough this example is rather trivial and could otherwise be expressed with a `while` loop in a generator, we'll consider more sophisticated cases.\n\nFor instance, you could examine the response from an Ajax request and if it indicates that more data is needed, you conditionally insert more steps into the iterable sequence to make the additional request(s). Or you could conditionally add a value-formatting step to the end of your Ajax handling.\n\nConsider:\n\n```js\nvar steps = ASQ.iterable()\n\n.then( function STEP1(token){\n\tvar url = token.messages[0].url;\n\n\t// was an additional formatting step provided?\n\tif (token.messages[0].format) {\n\t\tsteps.then( token.messages[0].format );\n\t}\n\n\treturn request( url );\n} )\n\n.then( function STEP2(resp){\n\t// add another Ajax request to the sequence?\n\tif (/x1/.test( resp )) {\n\t\tsteps.then( function STEP5(text){\n\t\t\treturn request(\n\t\t\t\t\"http://some.url.4/?v=\" + text\n\t\t\t);\n\t\t} );\n\t}\n\n\treturn ASQ().gate(\n\t\trequest( \"http://some.url.2/?v=\" + resp ),\n\t\trequest( \"http://some.url.3/?v=\" + resp )\n\t);\n} )\n\n.then( function STEP3(r1,r2){ return r1 + r2; } );\n```\n\nYou can see in two different places where we conditionally extend `steps` with `steps.then(..)`. And to run this `steps` iterable sequence, we just wire it into our main program flow with an *asynquence* sequence (called `main` here) using `ASQ#runner(..)`:\n\n```js\nvar main = ASQ( {\n\turl: \"http://some.url.1\",\n\tformat: function STEP4(text){\n\t\treturn text.toUpperCase();\n\t}\n} )\n.runner( steps )\n.val( function(msg){\n\tconsole.log( msg );\n} );\n```\n\nCan the flexibility (conditional behavior) of the `steps` iterable sequence be expressed with a generator? Kind of, but we have to rearrange the logic in a slightly awkward way:\n\n```js\nfunction *steps(token) {\n\t// **STEP 1**\n\tvar resp = yield request( token.messages[0].url );\n\n\t// **STEP 2**\n\tvar rvals = yield ASQ().gate(\n\t\trequest( \"http://some.url.2/?v=\" + resp ),\n\t\trequest( \"http://some.url.3/?v=\" + resp )\n\t);\n\n\t// **STEP 3**\n\tvar text = rvals[0] + rvals[1];\n\n\t// **STEP 4**\n\t// was an additional formatting step provided?\n\tif (token.messages[0].format) {\n\t\ttext = yield token.messages[0].format( text );\n\t}\n\n\t// **STEP 5**\n\t// need another Ajax request added to the sequence?\n\tif (/foobar/.test( resp )) {\n\t\ttext = yield request(\n\t\t\t\"http://some.url.4/?v=\" + text\n\t\t);\n\t}\n\n\treturn text;\n}\n\n// note: `*steps()` can be run by the same `ASQ` sequence\n// as `steps` was previously\n```\n\nSetting aside the already identified benefits of the sequential, synchronous-looking syntax of generators (see Chapter 4), the `steps` logic had to be reordered in the `*steps()` generator form, to fake the dynamicism of the extendable iterable sequence `steps`.\n\nWhat about expressing the functionality with Promises or sequences, though? You *can* do something like this:\n\n```js\nvar steps = something( .. )\n.then( .. )\n.then( function(..){\n\t// ..\n\n\t// extending the chain, right?\n\tsteps = steps.then( .. );\n\n\t// ..\n})\n.then( .. );\n```\n\nThe problem is subtle but important to grasp. So, consider trying to wire up our `steps` Promise chain into our main program flow -- this time expressed with Promises instead of *asynquence*:\n\n```js\nvar main = Promise.resolve( {\n\turl: \"http://some.url.1\",\n\tformat: function STEP4(text){\n\t\treturn text.toUpperCase();\n\t}\n} )\n.then( function(..){\n\treturn steps;\t\t\t// hint!\n} )\n.val( function(msg){\n\tconsole.log( msg );\n} );\n```\n\nCan you spot the problem now? Look closely!\n\nThere's a race condition for sequence steps ordering. When you `return steps`, at that moment `steps` *might* be the originally defined promise chain, or it might now point to the extended promise chain via the `steps = steps.then(..)` call, depending on what order things happen.\n\nHere are the two possible outcomes:\n\n* If `steps` is still the original promise chain, once it's later \"extended\" by `steps = steps.then(..)`, that extended promise on the end of the chain is **not** considered by the `main` flow, as it's already tapped the `steps` chain. This is the unfortunately limiting **eager evaluation**.\n* If `steps` is already the extended promise chain, it works as we expect in that the extended promise is what `main` taps.\n\nOther than the obvious fact that a race condition is intolerable, the first case is the concern; it illustrates **eager evaluation** of the promise chain. By contrast, we easily extended the iterable sequence without such issues, because iterable sequences are **lazily evaluated**.\n\nThe more dynamic you need your flow control, the more iterable sequences will shine.\n\n**Tip:** Check out more information and examples of iterable sequences on the *asynquence* site (https://github.com/getify/asynquence/blob/master/README.md#iterable-sequences).\n\n## Event Reactive\n\nIt should be obvious from (at least!) Chapter 3 that Promises are a very powerful tool in your async toolbox. But one thing that's clearly lacking is in their capability to handle streams of events, as a Promise can only be resolved once. And frankly, this exact same weakness is true of plain *asynquence* sequences, as well.\n\nConsider a scenario where you want to fire off a series of steps every time a certain event is fired. A single Promise or sequence cannot represent all occurrences of that event. So, you have to create a whole new Promise chain (or sequence) for *each* event occurrence, such as:\n\n```js\nlistener.on( \"foobar\", function(data){\n\n\t// create a new event handling promise chain\n\tnew Promise( function(resolve,reject){\n\t\t// ..\n\t} )\n\t.then( .. )\n\t.then( .. );\n\n} );\n```\n\nThe base functionality we need is present in this approach, but it's far from a desirable way to express our intended logic. There are two separate capabilities conflated in this paradigm: the event listening, and responding to the event; separation of concerns would implore us to separate out these capabilities.\n\nThe carefully observant reader will see this problem as somewhat symmetrical to the problems we detailed with callbacks in Chapter 2; it's kind of an inversion of control problem.\n\nImagine uninverting this paradigm, like so:\n\n```js\nvar observable = listener.on( \"foobar\" );\n\n// later\nobservable\n.then( .. )\n.then( .. );\n\n// elsewhere\nobservable\n.then( .. )\n.then( .. );\n```\n\nThe `observable` value is not exactly a Promise, but you can *observe* it much like you can observe a Promise, so it's closely related. In fact, it can be observed many times, and it will send out notifications every time its event (`\"foobar\"`) occurs.\n\n**Tip:** This pattern I've just illustrated is a **massive simplification** of the concepts and motivations behind reactive programming (aka RP), which has been implemented/expounded upon by several great projects and languages. A variation on RP is functional reactive programming (FRP), which refers to applying functional programming techniques (immutability, referential integrity, etc.) to streams of data. \"Reactive\" refers to spreading this functionality out over time in response to events. The interested reader should consider studying \"Reactive Observables\" in the fantastic \"Reactive Extensions\" library (\"RxJS\" for JavaScript) by Microsoft (http://rxjs.codeplex.com/); it's much more sophisticated and powerful than I've just shown. Also, Andre Staltz has an excellent write-up (https://gist.github.com/staltz/868e7e9bc2a7b8c1f754) that pragmatically lays out RP in concrete examples.\n\n### ES7 Observables\n\nAt the time of this writing, there's an early ES7 proposal for a new data type called \"Observable\" (https://github.com/jhusain/asyncgenerator#introducing-observable), which in spirit is similar to what we've laid out here, but is definitely more sophisticated.\n\nThe notion of this kind of Observable is that the way you \"subscribe\" to the events from a stream is to pass in a generator -- actually the *iterator* is the interested party -- whose `next(..)` method will be called for each event.\n\nYou could imagine it sort of like this:\n\n```js\n// `someEventStream` is a stream of events, like from\n// mouse clicks, and the like.\n\nvar observer = new Observer( someEventStream, function*(){\n\twhile (var evt = yield) {\n\t\tconsole.log( evt );\n\t}\n} );\n```\n\nThe generator you pass in will `yield` pause the `while` loop waiting for the next event. The *iterator* attached to the generator instance will have its `next(..)` called each time `someEventStream` has a new event published, and so that event data will resume your generator/*iterator* with the `evt` data.\n\nIn the subscription to events functionality here, it's the *iterator* part that matters, not the generator. So conceptually you could pass in practically any iterable, including `ASQ.iterable()` iterable sequences.\n\nInterestingly, there are also proposed adapters to make it easy to construct Observables from certain types of streams, such as `fromEvent(..)` for DOM events. If you look at a suggested implementation of `fromEvent(..)` in the earlier linked ES7 proposal, it looks an awful lot like the `ASQ.react(..)` we'll see in the next section.\n\nOf course, these are all early proposals, so what shakes out may very well look/behave differently than shown here. But it's exciting to see the early alignments of concepts across different libraries and language proposals!\n\n### Reactive Sequences\n\nWith that crazy brief summary of Observables (and F/RP) as our inspiration and motivation, I will now illustrate an adaptation of a small subset of \"Reactive Observables,\" which I call \"Reactive Sequences.\"\n\nFirst, let's start with how to create an Observable, using an *asynquence* plug-in utility called `react(..)`:\n\n```js\nvar observable = ASQ.react( function setup(next){\n\tlistener.on( \"foobar\", next );\n} );\n```\n\nNow, let's see how to define a sequence that \"reacts\" -- in F/RP, this is typically called \"subscribing\" -- to that `observable`:\n\n```js\nobservable\n.seq( .. )\n.then( .. )\n.val( .. );\n```\n\nSo, you just define the sequence by chaining off the Observable. That's easy, huh?\n\nIn F/RP, the stream of events typically channels through a set of functional transforms, like `scan(..)`, `map(..)`, `reduce(..)`, and so on. With reactive sequences, each event channels through a new instance of the sequence. Let's look at a more concrete example:\n\n```js\nASQ.react( function setup(next){\n\tdocument.getElementById( \"mybtn\" )\n\t.addEventListener( \"click\", next, false );\n} )\n.seq( function(evt){\n\tvar btnID = evt.target.id;\n\treturn request(\n\t\t\"http://some.url.1/?id=\" + btnID\n\t);\n} )\n.val( function(text){\n\tconsole.log( text );\n} );\n```\n\nThe \"reactive\" portion of the reactive sequence comes from assigning one or more event handlers to invoke the event trigger (calling `next(..)`).\n\nThe \"sequence\" portion of the reactive sequence is exactly like the sequences we've already explored: each step can be whatever asynchronous technique makes sense, from continuation callback to Promise to generator.\n\nOnce you set up a reactive sequence, it will continue to initiate instances of the sequence as long as the events keep firing. If you want to stop a reactive sequence, you can call `stop()`.\n\nIf a reactive sequence is `stop()`'d, you likely want the event handler(s) to be unregistered as well; you can register a teardown handler for this purpose:\n\n```js\nvar sq = ASQ.react( function setup(next,registerTeardown){\n\tvar btn = document.getElementById( \"mybtn\" );\n\n\tbtn.addEventListener( \"click\", next, false );\n\n\t// will be called once `sq.stop()` is called\n\tregisterTeardown( function(){\n\t\tbtn.removeEventListener( \"click\", next, false );\n\t} );\n} )\n.seq( .. )\n.then( .. )\n.val( .. );\n\n// later\nsq.stop();\n```\n\n**Note:** The `this` binding reference inside the `setup(..)` handler is the same `sq` reactive sequence, so you can use the `this` reference to add to the reactive sequence definition, call methods like `stop()`, and so on.\n\nHere's an example from the Node.js world, using reactive sequences to handle incoming HTTP requests:\n\n```js\nvar server = http.createServer();\nserver.listen(8000);\n\n// reactive observer\nvar request = ASQ.react( function setup(next,registerTeardown){\n\tserver.addListener( \"request\", next );\n\tserver.addListener( \"close\", this.stop );\n\n\tregisterTeardown( function(){\n\t\tserver.removeListener( \"request\", next );\n\t\tserver.removeListener( \"close\", request.stop );\n\t} );\n});\n\n// respond to requests\nrequest\n.seq( pullFromDatabase )\n.val( function(data,res){\n\tres.end( data );\n} );\n\n// node teardown\nprocess.on( \"SIGINT\", request.stop );\n```\n\nThe `next(..)` trigger can also adapt to node streams easily, using `onStream(..)` and `unStream(..)`:\n\n```js\nASQ.react( function setup(next){\n\tvar fstream = fs.createReadStream( \"/some/file\" );\n\n\t// pipe the stream's \"data\" event to `next(..)`\n\tnext.onStream( fstream );\n\n\t// listen for the end of the stream\n\tfstream.on( \"end\", function(){\n\t\tnext.unStream( fstream );\n\t} );\n} )\n.seq( .. )\n.then( .. )\n.val( .. );\n```\n\nYou can also use sequence combinations to compose multiple reactive sequence streams:\n\n```js\nvar sq1 = ASQ.react( .. ).seq( .. ).then( .. );\nvar sq2 = ASQ.react( .. ).seq( .. ).then( .. );\n\nvar sq3 = ASQ.react(..)\n.gate(\n\tsq1,\n\tsq2\n)\n.then( .. );\n```\n\nThe main takeaway is that `ASQ.react(..)` is a lightweight adaptation of F/RP concepts, enabling the wiring of an event stream to a sequence, hence the term \"reactive sequence.\" Reactive sequences are generally capable enough for basic reactive uses.\n\n**Note:** Here's an example of using `ASQ.react(..)` in managing UI state (http://jsbin.com/rozipaki/6/edit?js,output), and another example of handling HTTP request/response streams with `ASQ.react(..)` (https://gist.github.com/getify/bba5ec0de9d6047b720e).\n\n## Generator Coroutine\n\nHopefully Chapter 4 helped you get pretty familiar with ES6 generators. In particular, we want to revisit the \"Generator Concurrency\" discussion, and push it even further.\n\nWe imagined a `runAll(..)` utility that could take two or more generators and run them concurrently, letting them cooperatively `yield` control from one to the next, with optional message passing.\n\nIn addition to being able to run a single generator to completion, the `ASQ#runner(..)` we discussed in Appendix A is a similar implementation of the concepts of `runAll(..)`, which can run multiple generators concurrently to completion.\n\nSo let's see how we can implement the concurrent Ajax scenario from Chapter 4:\n\n```js\nASQ(\n\t\"http://some.url.2\"\n)\n.runner(\n\tfunction*(token){\n\t\t// transfer control\n\t\tyield token;\n\n\t\tvar url1 = token.messages[0]; // \"http://some.url.1\"\n\n\t\t// clear out messages to start fresh\n\t\ttoken.messages = [];\n\n\t\tvar p1 = request( url1 );\n\n\t\t// transfer control\n\t\tyield token;\n\n\t\ttoken.messages.push( yield p1 );\n\t},\n\tfunction*(token){\n\t\tvar url2 = token.messages[0]; // \"http://some.url.2\"\n\n\t\t// message pass and transfer control\n\t\ttoken.messages[0] = \"http://some.url.1\";\n\t\tyield token;\n\n\t\tvar p2 = request( url2 );\n\n\t\t// transfer control\n\t\tyield token;\n\n\t\ttoken.messages.push( yield p2 );\n\n\t\t// pass along results to next sequence step\n\t\treturn token.messages;\n\t}\n)\n.val( function(res){\n\t// `res[0]` comes from \"http://some.url.1\"\n\t// `res[1]` comes from \"http://some.url.2\"\n} );\n```\n\nThe main differences between `ASQ#runner(..)` and `runAll(..)` are as follows:\n\n* Each generator (coroutine) is provided an argument we call `token`, which is the special value to `yield` when you want to explicitly transfer control to the next coroutine.\n* `token.messages` is an array that holds any messages passed in from the previous sequence step. It's also a data structure that you can use to share messages between coroutines.\n* `yield`ing a Promise (or sequence) value does not transfer control, but instead pauses the coroutine processing until that value is ready.\n* The last `return`ed or `yield`ed value from the coroutine processing run will be forward passed to the next step in the sequence.\n\nIt's also easy to layer helpers on top of the base `ASQ#runner(..)` functionality to suit different uses.\n\n### State Machines\n\nOne example that may be familiar to many programmers is state machines. You can, with the help of a simple cosmetic utility, create an easy-to-express state machine processor.\n\nLet's imagine such a utility. We'll call it `state(..)`, and will pass it two arguments: a state value and a generator that handles that state. `state(..)` will do the dirty work of creating and returning an adapter generator to pass to `ASQ#runner(..)`.\n\nConsider:\n\n```js\nfunction state(val,handler) {\n\t// make a coroutine handler for this state\n\treturn function*(token) {\n\t\t// state transition handler\n\t\tfunction transition(to) {\n\t\t\ttoken.messages[0] = to;\n\t\t}\n\n\t\t// set initial state (if none set yet)\n\t\tif (token.messages.length < 1) {\n\t\t\ttoken.messages[0] = val;\n\t\t}\n\n\t\t// keep going until final state (false) is reached\n\t\twhile (token.messages[0] !== false) {\n\t\t\t// current state matches this handler?\n\t\t\tif (token.messages[0] === val) {\n\t\t\t\t// delegate to state handler\n\t\t\t\tyield *handler( transition );\n\t\t\t}\n\n\t\t\t// transfer control to another state handler?\n\t\t\tif (token.messages[0] !== false) {\n\t\t\t\tyield token;\n\t\t\t}\n\t\t}\n\t};\n}\n```\n\nIf you look closely, you'll see that `state(..)` returns back a generator that accepts a `token`, and then it sets up a `while` loop that will run until the state machine reaches its final state (which we arbitrarily pick as the `false` value); that's exactly the kind of generator we want to pass to `ASQ#runner(..)`!\n\nWe also arbitrarily reserve the `token.messages[0]` slot as the place where the current state of our state machine will be tracked, which means we can even seed the initial state as the value passed in from the previous step in the sequence.\n\nHow do we use the `state(..)` helper along with `ASQ#runner(..)`?\n\n```js\nvar prevState;\n\nASQ(\n\t/* optional: initial state value */\n\t2\n)\n// run our state machine\n// transitions: 2 -> 3 -> 1 -> 3 -> false\n.runner(\n\t// state `1` handler\n\tstate( 1, function *stateOne(transition){\n\t\tconsole.log( \"in state 1\" );\n\n\t\tprevState = 1;\n\t\tyield transition( 3 );\t// goto state `3`\n\t} ),\n\n\t// state `2` handler\n\tstate( 2, function *stateTwo(transition){\n\t\tconsole.log( \"in state 2\" );\n\n\t\tprevState = 2;\n\t\tyield transition( 3 );\t// goto state `3`\n\t} ),\n\n\t// state `3` handler\n\tstate( 3, function *stateThree(transition){\n\t\tconsole.log( \"in state 3\" );\n\n\t\tif (prevState === 2) {\n\t\t\tprevState = 3;\n\t\t\tyield transition( 1 ); // goto state `1`\n\t\t}\n\t\t// all done!\n\t\telse {\n\t\t\tyield \"That's all folks!\";\n\n\t\t\tprevState = 3;\n\t\t\tyield transition( false ); // terminal state\n\t\t}\n\t} )\n)\n// state machine complete, so move on\n.val( function(msg){\n\tconsole.log( msg );\t// That's all folks!\n} );\n```\n\nIt's important to note that the `*stateOne(..)`, `*stateTwo(..)`, and `*stateThree(..)` generators themselves are reinvoked each time that state is entered, and they finish when you `transition(..)` to another value. While not shown here, of course these state generator handlers can be asynchronously paused by `yield`ing Promises/sequences/thunks.\n\nThe underneath hidden generators produced by the `state(..)` helper and actually passed to `ASQ#runner(..)` are the ones that continue to run concurrently for the length of the state machine, and each of them handles cooperatively `yield`ing control to the next, and so on.\n\n**Note:** See this \"ping pong\" example (http://jsbin.com/qutabu/1/edit?js,output) for more illustration of using cooperative concurrency with generators driven by `ASQ#runner(..)`.\n\n## Communicating Sequential Processes (CSP)\n\n\"Communicating Sequential Processes\" (CSP) was first described by C. A. R. Hoare in a 1978 academic paper (http://dl.acm.org/citation.cfm?doid=359576.359585), and later in a 1985 book (http://www.usingcsp.com/) of the same name. CSP describes a formal method for concurrent \"processes\" to interact (aka \"communicate\") during processing.\n\nYou may recall that we examined concurrent \"processes\" back in Chapter 1, so our exploration of CSP here will build upon that understanding.\n\nLike most great concepts in computer science, CSP is heavily steeped in academic formalism, expressed as a process algebra. However, I suspect symbolic algebra theorems won't make much practical difference to the reader, so we will want to find some other way of wrapping our brains around CSP.\n\nI will leave much of the formal description and proof of CSP to Hoare's writing, and to many other fantastic writings since. Instead, we will try to just briefly explain the idea of CSP in as un-academic and hopefully intuitively understandable a way as possible.\n\n### Message Passing\n\nThe core principle in CSP is that all communication/interaction between otherwise independent processes must be through formal message passing. Perhaps counter to your expectations, CSP message passing is described as a synchronous action, where the sender process and the receiver process have to mutually be ready for the message to be passed.\n\nHow could such synchronous messaging possibly be related to asynchronous programming in JavaScript?\n\nThe concreteness of relationship comes from the nature of how ES6 generators are used to produce synchronous-looking actions that under the covers can indeed either be synchronous or (more likely) asynchronous.\n\nIn other words, two or more concurrently running generators can appear to synchronously message each other while preserving the fundamental asynchrony of the system because each generator's code is paused (aka \"blocked\") waiting on resumption of an asynchronous action.\n\nHow does this work?\n\nImagine a generator (aka \"process\") called \"A\" that wants to send a message to generator \"B.\" First, \"A\" `yield`s the message (thus pausing \"A\") to be sent to \"B.\" When \"B\" is ready and takes the message, \"A\" is then resumed (unblocked).\n\nSymmetrically, imagine a generator \"A\" that wants a message **from** \"B.\" \"A\" `yield`s its request (thus pausing \"A\") for the message from \"B,\" and once \"B\" sends a message, \"A\" takes the message and is resumed.\n\nOne of the more popular expressions of this CSP message passing theory comes from ClojureScript's core.async library, and also from the *go* language. These takes on CSP embody the described communication semantics in a conduit that is opened between processes called a \"channel.\"\n\n**Note:** The term *channel* is used in part because there are modes in which more than one value can be sent at once into the \"buffer\" of the channel; this is similar to what you may think of as a stream. We won't go into depth about it here, but it can be a very powerful technique for managing streams of data.\n\nIn the simplest notion of CSP, a channel that we create between \"A\" and \"B\" would have a method called `take(..)` for blocking to receive a value, and a method called `put(..)` for blocking to send a value.\n\nThis might look like:\n\n```js\nvar ch = channel();\n\nfunction *foo() {\n\tvar msg = yield take( ch );\n\n\tconsole.log( msg );\n}\n\nfunction *bar() {\n\tyield put( ch, \"Hello World\" );\n\n\tconsole.log( \"message sent\" );\n}\n\nrun( foo );\nrun( bar );\n// Hello World\n// \"message sent\"\n```\n\nCompare this structured, synchronous(-looking) message passing interaction to the informal and unstructured message sharing that `ASQ#runner(..)` provides through the `token.messages` array and cooperative `yield`ing. In essence, `yield put(..)` is a single operation that both sends the value and pauses execution to transfer control, whereas in earlier examples we did those as separate steps.\n\nMoreover, CSP stresses that you don't really explicitly \"transfer control,\" but rather you design your concurrent routines to block expecting either a value received from the channel, or to block expecting to try to send a message on the channel. The blocking around receiving or sending messages is how you coordinate sequencing of behavior between the coroutines.\n\n**Note:** Fair warning: this pattern is very powerful but it's also a little mind twisting to get used to at first. You will want to practice this a bit to get used to this new way of thinking about coordinating your concurrency.\n\nThere are several great libraries that have implemented this flavor of CSP in JavaScript, most notably \"js-csp\" (https://github.com/ubolonton/js-csp), which James Long (http://twitter.com/jlongster) forked (https://github.com/jlongster/js-csp) and has written extensively about (http://jlongster.com/Taming-the-Asynchronous-Beast-with-CSP-in-JavaScript). Also, it cannot be stressed enough how amazing the many writings of David Nolen (http://twitter.com/swannodette) are on the topic of adapting ClojureScript's go-style core.async CSP into JS generators (http://swannodette.github.io/2013/08/24/es6-generators-and-csp/).\n\n### asynquence CSP emulation\n\nBecause we've been discussing async patterns here in the context of my *asynquence* library, you might be interested to see that we can fairly easily add an emulation layer on top of `ASQ#runner(..)` generator handling as a nearly perfect porting of the CSP API and behavior. This emulation layer ships as an optional part of the \"asynquence-contrib\" package alongside *asynquence*.\n\nVery similar to the `state(..)` helper from earlier, `ASQ.csp.go(..)` takes a generator -- in go/core.async terms, it's known as a goroutine -- and adapts it to use with `ASQ#runner(..)` by returning a new generator.\n\nInstead of being passed a `token`, your goroutine receives an initially created channel (`ch` below) that all goroutines in this run will share. You can create more channels (which is often quite helpful!) with `ASQ.csp.chan(..)`.\n\nIn CSP, we model all asynchrony in terms of blocking on channel messages, rather than blocking waiting for a Promise/sequence/thunk to complete.\n\nSo, instead of `yield`ing the Promise returned from `request(..)`, `request(..)` should return a channel that you `take(..)` a value from. In other words, a single-value channel is roughly equivalent in this context/usage to a Promise/sequence.\n\nLet's first make a channel-aware version of `request(..)`:\n\n```js\nfunction request(url) {\n\tvar ch = ASQ.csp.channel();\n\tajax( url ).then( function(content){\n\t\t// `putAsync(..)` is a version of `put(..)` that\n\t\t// can be used outside of a generator. It returns\n\t\t// a promise for the operation's completion. We\n\t\t// don't use that promise here, but we could if\n\t\t// we needed to be notified when the value had\n\t\t// been `take(..)`n.\n\t\tASQ.csp.putAsync( ch, content );\n\t} );\n\treturn ch;\n}\n```\n\nFrom Chapter 3, \"promisory\" is a Promise-producing utility, \"thunkory\" from Chapter 4 is a thunk-producing utility, and finally, in Appendix A we invented \"sequory\" for a sequence-producing utility.\n\nNaturally, we need to coin a symmetric term here for a channel-producing utility. So let's unsurprisingly call it a \"chanory\" (\"channel\" + \"factory\"). As an exercise for the reader, try your hand at defining a `channelify(..)` utility similar to `Promise.wrap(..)`/`promisify(..)` (Chapter 3), `thunkify(..)` (Chapter 4), and `ASQ.wrap(..)` (Appendix A).\n\nNow consider the concurrent Ajax example using *asyquence*-flavored CSP:\n\n```js\nASQ()\n.runner(\n\tASQ.csp.go( function*(ch){\n\t\tyield ASQ.csp.put( ch, \"http://some.url.2\" );\n\n\t\tvar url1 = yield ASQ.csp.take( ch );\n\t\t// \"http://some.url.1\"\n\n\t\tvar res1 = yield ASQ.csp.take( request( url1 ) );\n\n\t\tyield ASQ.csp.put( ch, res1 );\n\t} ),\n\tASQ.csp.go( function*(ch){\n\t\tvar url2 = yield ASQ.csp.take( ch );\n\t\t// \"http://some.url.2\"\n\n\t\tyield ASQ.csp.put( ch, \"http://some.url.1\" );\n\n\t\tvar res2 = yield ASQ.csp.take( request( url2 ) );\n\t\tvar res1 = yield ASQ.csp.take( ch );\n\n\t\t// pass along results to next sequence step\n\t\tch.buffer_size = 2;\n\t\tASQ.csp.put( ch, res1 );\n\t\tASQ.csp.put( ch, res2 );\n\t} )\n)\n.val( function(res1,res2){\n\t// `res1` comes from \"http://some.url.1\"\n\t// `res2` comes from \"http://some.url.2\"\n} );\n```\n\nThe message passing that trades the URL strings between the two goroutines is pretty straightforward. The first goroutine makes an Ajax request to the first URL, and that response is put onto the `ch` channel. The second goroutine makes an Ajax request to the second URL, then gets the first response `res1` off the `ch` channel. At that point, both responses `res1` and `res2` are completed and ready.\n\nIf there are any remaining values in the `ch` channel at the end of the goroutine run, they will be passed along to the next step in the sequence. So, to pass out message(s) from the final goroutine, `put(..)` them into `ch`. As shown, to avoid the blocking of those final `put(..)`s, we switch `ch` into buffering mode by setting its `buffer_size` to `2` (default: `0`).\n\n**Note:** See many more examples of using *asynquence*-flavored CSP here (https://gist.github.com/getify/e0d04f1f5aa24b1947ae).\n\n## Review\n\nPromises and generators provide the foundational building blocks upon which we can build much more sophisticated and capable asynchrony.\n\n*asynquence* has utilities for implementing *iterable sequences*, *reactive sequences* (aka \"Observables\"), *concurrent coroutines*, and even *CSP goroutines*.\n\nThose patterns, combined with the continuation-callback and Promise capabilities, gives *asynquence* a powerful mix of different asynchronous functionalities, all integrated in one clean async flow control abstraction: the sequence.\n"
},
{
"path": "async & performance/apC.md",
"content": "# Вы не знаете JS: Асинхронность и Производительность\n# Приложение C: Благодарности\n\nЕсть множество людей, которых нужно поблагодарить за то, что появилась на свет эта книга и вся серия.\n\nВо-первых, я должен поблагодарить мою жену Кристен Симпсон (Christen Simpson) и двух моих детей Итана (Ethan) и Эмили (Emily), за то, что мирились с тем, что их папу вечно надо было отрывать от компьютера. Даже когда я не писал книги, моя одержимость JavaScript приклеивала мой взгляд к экрану больше, чем следовало. То время, которое я занял у моей семьи, и есть причина, по которой эти книги могут так глубоко и полностью объяснить JavaScript для вас, читатель. Я в большом долгу перед своей семьей.\n\nХочу поблагодарить моих редакторов в O'Reilly, а именно Simon St.Laurent и Brian MacDonald, как и остальных в команде редакторов и маркетинга. Работать с ними — одно удовольствие, и хочется особенно поблагодарить их за создание подходящих условий во время этого эксперимента с написанием \"open source\"-книги, за редактирование и выпуск.\n\nСпасибо всем тем, кто участвовал в улучшении этой серии книг присылая предложения по редактированию и корректировке, включая Shelley Powers, Tim Ferro, Evan Borden, Forrest L. Norvell, Jennifer Davis, Jesse Harlin и многих других. Большое спасибо Shane Hudson за написание предисловия к этой серии книг.\n\nСпасибо бесчисленным участникам сообщества, включая членов комитета TC39, кто поделился столько многим с нами и особенно за терпеливое отношение к моим бесконечным вопросам и изысканиям. John-David Dalton, Juriy \"kangax\" Zaytsev, Mathias Bynens, Axel Rauschmayer, Nicholas Zakas, Angus Croll, Reginald Braithwaite, Dave Herman, Brendan Eich, Allen Wirfs-Brock, Bradley Meck, Domenic Denicola, David Walsh, Tim Disney, Peter van der Zee, Andrea Giammarchi, Kit Cambridge, Eric Elliott и многие другие, я упомянул лишь малую часть.\n\nСерия книг *Вы не знаете JS* родилась на Kickstarter, поэтому я также хочу поблагодарить всех моих (почти) 500 щедрых инвесторов, без которых эта серия книг не появилась бы:\n\n> Jan Szpila, nokiko, Murali Krishnamoorthy, Ryan Joy, Craig Patchett, pdqtrader, Dale Fukami, ray hatfield, R0drigo Perez [Mx], Dan Petitt, Jack Franklin, Andrew Berry, Brian Grinstead, Rob Sutherland, Sergi Meseguer, Phillip Gourley, Mark Watson, Jeff Carouth, Alfredo Sumaran, Martin Sachse, Marcio Barrios, Dan, AimelyneM, Matt Sullivan, Delnatte Pierre-Antoine, Jake Smith, Eugen Tudorancea, Iris, David Trinh, simonstl, Ray Daly, Uros Gruber, Justin Myers, Shai Zonis, Mom & Dad, Devin Clark, Dennis Palmer, Brian Panahi Johnson, Josh Marshall, Marshall, Dennis Kerr, Matt Steele, Erik Slagter, Sacah, Justin Rainbow, Christian Nilsson, Delapouite, D.Pereira, Nicolas Hoizey, George V. Reilly, Dan Reeves, Bruno Laturner, Chad Jennings, Shane King, Jeremiah Lee Cohick, od3n, Stan Yamane, Marko Vucinic, Jim B, Stephen Collins, Ægir Þorsteinsson, Eric Pederson, Owain, Nathan Smith, Jeanetteurphy, Alexandre ELISÉ, Chris Peterson, Rik Watson, Luke Matthews, Justin Lowery, Morten Nielsen, Vernon Kesner, Chetan Shenoy, Paul Tregoing, Marc Grabanski, Dion Almaer, Andrew Sullivan, Keith Elsass, Tom Burke, Brian Ashenfelter, David Stuart, Karl Swedberg, Graeme, Brandon Hays, John Christopher, Gior, manoj reddy, Chad Smith, Jared Harbour, Minoru TODA, Chris Wigley, Daniel Mee, Mike, Handyface, Alex Jahraus, Carl Furrow, Rob Foulkrod, Max Shishkin, Leigh Penny Jr., Robert Ferguson, Mike van Hoenselaar, Hasse Schougaard, rajan venkataguru, Jeff Adams, Trae Robbins, Rolf Langenhuijzen, Jorge Antunes, Alex Koloskov, Hugh Greenish, Tim Jones, Jose Ochoa, Michael Brennan-White, Naga Harish Muvva, Barkóczi Dávid, Kitt Hodsden, Paul McGraw, Sascha Goldhofer, Andrew Metcalf, Markus Krogh, Michael Mathews, Matt Jared, Juanfran, Georgie Kirschner, Kenny Lee, Ted Zhang, Amit Pahwa, Inbal Sinai, Dan Raine, Schabse Laks, Michael Tervoort, Alexandre Abreu, Alan Joseph Williams, NicolasD, Cindy Wong, Reg Braithwaite, LocalPCGuy, Jon Friskics, Chris Merriman, John Pena, Jacob Katz, Sue Lockwood, Magnus Johansson, Jeremy Crapsey, Grzegorz Pawłowski, nico nuzzaci, Christine Wilks, Hans Bergren, charles montgomery, Ariel בר-לבב Fogel, Ivan Kolev, Daniel Campos, Hugh Wood, Christian Bradford, Frédéric Harper, Ionuţ Dan Popa, Jeff Trimble, Rupert Wood, Trey Carrico, Pancho Lopez, Joël kuijten, Tom A Marra, Jeff Jewiss, Jacob Rios, Paolo Di Stefano, Soledad Penades, Chris Gerber, Andrey Dolganov, Wil Moore III, Thomas Martineau, Kareem, Ben Thouret, Udi Nir, Morgan Laupies, jory carson-burson, Nathan L Smith, Eric Damon Walters, Derry Lozano-Hoyland, Geoffrey Wiseman, mkeehner, KatieK, Scott MacFarlane, Brian LaShomb, Adrien Mas, christopher ross, Ian Littman, Dan Atkinson, Elliot Jobe, Nick Dozier, Peter Wooley, John Hoover, dan, Martin A. Jackson, Héctor Fernando Hurtado, andy ennamorato, Paul Seltmann, Melissa Gore, Dave Pollard, Jack Smith, Philip Da Silva, Guy Israeli, @megalithic, Damian Crawford, Felix Gliesche, April Carter Grant, Heidi, jim tierney, Andrea Giammarchi, Nico Vignola, Don Jones, Chris Hartjes, Alex Howes, john gibbon, David J. Groom, BBox, Yu 'Dilys' Sun, Nate Steiner, Brandon Satrom, Brian Wyant, Wesley Hales, Ian Pouncey, Timothy Kevin Oxley, George Terezakis, sanjay raj, Jordan Harband, Marko McLion, Wolfgang Kaufmann, Pascal Peuckert, Dave Nugent, Markus Liebelt, Welling Guzman, Nick Cooley, Daniel Mesquita, Robert Syvarth, Chris Coyier, Rémy Bach, Adam Dougal, Alistair Duggin, David Loidolt, Ed Richer, Brian Chenault, GoldFire Studios, Carles Andrés, Carlos Cabo, Yuya Saito, roberto ricardo, Barnett Klane, Mike Moore, Kevin Marx, Justin Love, Joe Taylor, Paul Dijou, Michael Kohler, Rob Cassie, Mike Tierney, Cody Leroy Lindley, tofuji, Shimon Schwartz, Raymond, Luc De Brouwer, David Hayes, Rhys Brett-Bowen, Dmitry, Aziz Khoury, Dean, Scott Tolinski - Level Up, Clement Boirie, Djordje Lukic, Anton Kotenko, Rafael Corral, Philip Hurwitz, Jonathan Pidgeon, Jason Campbell, Joseph C., SwiftOne, Jan Hohner, Derick Bailey, getify, Daniel Cousineau, Chris Charlton, Eric Turner, David Turner, Joël Galeran, Dharma Vagabond, adam, Dirk van Bergen, dave ♥♫★ furf, Vedran Zakanj, Ryan McAllen, Natalie Patrice Tucker, Eric J. Bivona, Adam Spooner, Aaron Cavano, Kelly Packer, Eric J, Martin Drenovac, Emilis, Michael Pelikan, Scott F. Walter, Josh Freeman, Brandon Hudgeons, vijay chennupati, Bill Glennon, Robin R., Troy Forster, otaku_coder, Brad, Scott, Frederick Ostrander, Adam Brill, Seb Flippence, Michael Anderson, Jacob, Adam Randlett, Standard, Joshua Clanton, Sebastian Kouba, Chris Deck, SwordFire, Hannes Papenberg, Richard Woeber, hnzz, Rob Crowther, Jedidiah Broadbent, Sergey Chernyshev, Jay-Ar Jamon, Ben Combee, luciano bonachela, Mark Tomlinson, Kit Cambridge, Michael Melgares, Jacob Adams, Adrian Bruinhout, Bev Wieber, Scott Puleo, Thomas Herzog, April Leone, Daniel Mizieliński, Kees van Ginkel, Jon Abrams, Erwin Heiser, Avi Laviad, David newell, Jean-Francois Turcot, Niko Roberts, Erik Dana, Charles Neill, Aaron Holmes, Grzegorz Ziółkowski, Nathan Youngman, Timothy, Jacob Mather, Michael Allan, Mohit Seth, Ryan Ewing, Benjamin Van Treese, Marcelo Santos, Denis Wolf, Phil Keys, Chris Yung, Timo Tijhof, Martin Lekvall, Agendine, Greg Whitworth, Helen Humphrey, Dougal Campbell, Johannes Harth, Bruno Girin, Brian Hough, Darren Newton, Craig McPheat, Olivier Tille, Dennis Roethig, Mathias Bynens, Brendan Stromberger, sundeep, John Meyer, Ron Male, John F Croston III, gigante, Carl Bergenhem, B.J. May, Rebekah Tyler, Ted Foxberry, Jordan Reese, Terry Suitor, afeliz, Tom Kiefer, Darragh Duffy, Kevin Vanderbeken, Andy Pearson, Simon Mac Donald, Abid Din, Chris Joel, Tomas Theunissen, David Dick, Paul Grock, Brandon Wood, John Weis, dgrebb, Nick Jenkins, Chuck Lane, Johnny Megahan, marzsman, Tatu Tamminen, Geoffrey Knauth, Alexander Tarmolov, Jeremy Tymes, Chad Auld, Sean Parmelee, Rob Staenke, Dan Bender, Yannick derwa, Joshua Jones, Geert Plaisier, Tom LeZotte, Christen Simpson, Stefan Bruvik, Justin Falcone, Carlos Santana, Michael Weiss, Pablo Villoslada, Peter deHaan, Dimitris Iliopoulos, seyDoggy, Adam Jordens, Noah Kantrowitz, Amol M, Matthew Winnard, Dirk Ginader, Phinam Bui, David Rapson, Andrew Baxter, Florian Bougel, Michael George, Alban Escalier, Daniel Sellers, Sasha Rudan, John Green, Robert Kowalski, David I. Teixeira (@ditma, Charles Carpenter, Justin Yost, Sam S, Denis Ciccale, Kevin Sheurs, Yannick Croissant, Pau Fracés, Stephen McGowan, Shawn Searcy, Chris Ruppel, Kevin Lamping, Jessica Campbell, Christopher Schmitt, Sablons, Jonathan Reisdorf, Bunni Gek, Teddy Huff, Michael Mullany, Michael Fürstenberg, Carl Henderson, Rick Yoesting, Scott Nichols, Hernán Ciudad, Andrew Maier, Mike Stapp, Jesse Shawl, Sérgio Lopes, jsulak, Shawn Price, Joel Clermont, Chris Ridmann, Sean Timm, Jason Finch, Aiden Montgomery, Elijah Manor, Derek Gathright, Jesse Harlin, Dillon Curry, Courtney Myers, Diego Cadenas, Arne de Bree, João Paulo Dubas, James Taylor, Philipp Kraeutli, Mihai Păun, Sam Gharegozlou, joshjs, Matt Murchison, Eric Windham, Timo Behrmann, Andrew Hall, joshua price, Théophile Villard\n\nЭта серия книг выпускается в стиле \"open source\", включая редактирование и выпуск. Мы отдаем дань благодарности GitHub за предоставление такой возможности для сообщества!\n\nЕще раз спасибо всех бесчисленным людям, которых я не перечислил по имени, но кого я тем не менее должен поблагодарить. Пусть эта серия книг будет \"принадлежать\" всем нам и служить вкладом в увеличение информированности и понимании языка JavaScript, на благо все нынешних и будущих вкладчиков в общее дело сообщества.\n"
},
{
"path": "async & performance/ch1.md",
"content": "# Вы не знаете JS: Асинхронность и Выполнение\n# Глава 1: Асинхронность: Сейчас и Потом\n\nУправление программой в течении её времени выполнения является глубокой и, в то же время, важной темой для понимания Javascript.\n\nИмеется ввиду не только то, что происходит от начала 'for' цикла и до его завершения, выполнение которого занимает, в основном, небольшой промежуток времени (от микро до миллисекунд), но и, то, что случается между запуском одной части программы *сейчас* и другой *позже* -- в этом промежутке, когда она не в активном исполнении.\n\nПрактически, все нетривиальные программы (особенно, написанные на Javascript) управляют выше упомянутым промежутком, будь то ожидание ввода данных пользователем, запрос информации с базы данных или файловой системы, отправка данных по сети и ожидание ответа, или выполнение повторяющихся действий в заданном интервале (анимация). Во всех этих случаях, ваша программа должна управлять своим состоянием во время этой \"паузы\" в ходе своего исполнения. Как говорят в Лондоне \"Mind the gap!\"(дословно -- \"Помни о разрыве\") -- надпись на платформе, предупреждающая о расстоянии между её краем и дверью поезда.\n\nНа самом деле, отношение *сейчас* и *потом* частей вашей программы является сердцем асинхронного программирования.\n\nАсинхронное программирование существовало в JS изначально. Но многие разработчики не вдавались в подробности как именно оно работает в их программах, или находили *другие* способы управления им. *Почти хорошим* подходом считалась скромная callback функция. Многие до сих пор считают, что callback'и являются эффективным решением.\n\nНо с ростом масштаба и сложности JS, для удовлетворения постоянно расширяющихся требований первоклассного языка программирования, работающего как в браузерах так и на серверах, и на любых мыслимых устройствах, между прочим, росла и боль с которой приходилось управлять асинхронностью.\n\nСейчас это все может показаться довольно абстрактным. Но я вас уверяю, что мы углубимся в детали и изучим множество новых методов для асинхронного программирования в JavaScript в следующих главах.\n\nДля этого нам надо разобраться во всех тонкостях асинхронности в JS.\n\n## Программа по кусочкам\n\nДаже, если вы пишете ваш код в одном *.js* файле, ваша программа почти наверняка состоит из нескольких *кусочков*, один из которых выполнится *сейчас*, а остальные *потом*. Наиболее распространенная единица *кусочка* - 'function'.\n\nБольшинство новоприбывших в JS разработчиков думают, что асинхронный код приостанавливается для выполнения, но это не так.\n\nДавайте посмотрим:\n\n```js\n// ajax(..) обычная ajax функция\nvar data = ajax( \"http://some.url.1\" );\n\nconsole.log( data );\n// Упс! `данные` не получены\n```\n\nВы вероятно знаете, что Ajax запросы не выполняются синхронно, а это значит, что `ajax(..)` функция ещё не получила данных для присвоения в переменную `data`. Если бы `ajax(..)` запрос мог бы приостановить код для получения данных, тогда бы `data` не была пуста. \n\nПростейшая (но далеко не самая лучшая) реализация Ajax -- это использование функции callback. \n\n```js\najax( \"http://some.url.1\", function myCallbackFunction(data){\n\n\tconsole.log( data ); // Ура, Я получил `data`!\n\n} );\n```\n\n**Предупреждение.** Возможно, вы слышали, что можно выполнять синхронные запросы Ajax. Хотя технически это верно, вы никогда не должны этого делать ни при каких обстоятельствах, потому что это блокирует пользовательский интерфейс браузера (кнопки, меню, прокрутку и т.д.) и предотвращает любое взаимодействие с пользователем. Это ужасная идея, и ее всегда следует избегать.\n\nПрежде чем возражать против несогласия, нет, ваше желание избежать путаницы с колбеками *не* является оправданием для блокировки синхронного Ajax.\n\nНапример, рассмотрим этот код:\n\n```js\nfunction now() {\n\treturn 21;\n}\n\nfunction later() {\n\tanswer = answer * 2;\n\tconsole.log( \"Meaning of life:\", answer );\n}\n\nvar answer = now();\n\nsetTimeout( later, 1000 ); // Meaning of life: 42\n```\n\nВ этой программе есть две части: то, что будет запущено *сейчас*, и то, что будет запущено *позже*. Должно быть довольно очевидно, что это за два фрагмента, но давайте будем очень явными:\n\nСейчас:\n```js\nfunction now() {\n\treturn 21;\n}\n\nfunction later() { .. }\n\nvar answer = now();\n\nsetTimeout( later, 1000 );\n```\n\nПозже:\n```js\nanswer = answer * 2;\nconsole.log( \"Meaning of life:\", answer );\n```\n\nБлок *now* запускается сразу же, как только вы запускаете свою программу. Но `setTimeout(..)` также устанавливает событие (тайм-аут), которое произойдет *позже*, поэтому содержимое функции `later()` будет выполнено позже (через 1000 миллисекунд).\n\nКаждый раз, когда вы заключаете часть кода в `функцию` и указываете, что она должна выполняться в ответ на какое-то событие (таймер, щелчок мышью, ответ Ajax и т.д.), вы создаете более позднюю* часть своего кода, и, таким образом, вводя асинхронность в вашу программу.\n\n### Асинхронная консоль\n\nНе существует спецификации или набора требований относительно того, как работают методы `console.*` — они официально не являются частью JavaScript, а вместо этого добавляются в JS *средой всплытия* (см. заголовок *Типы и грамматика* эту серию книг).\n\nТаким образом, разные браузеры и среды JS делают то, что им заблагорассудится, что иногда может привести к путанице.\n\nВ частности, есть некоторые браузеры и некоторые условия, при которых `console.log(..)` на самом деле не сразу выводит то, что ему дано. Основная причина, по которой это может произойти, заключается в том, что ввод-вывод является очень медленной и блокирующей частью многих программ (не только JS). Таким образом, браузер может лучше (с точки зрения страницы/интерфейса) обрабатывать «консольный» ввод-вывод асинхронно в фоновом режиме, и вы, возможно, даже не подозреваете об этом.\n\nНе очень распространенный, но возможный сценарий, в котором это может быть *наблюдаемо* (не из самого кода, а извне):\n\n```js\nvar a = {\n\tindex: 1\n};\n\n// позже\nconsole.log( a ); // ??\n\n// ещё позже\na.index++;\n```\n\nОбычно мы ожидаем, что снимок объекта `a` будет сделан точно в момент выполнения оператора `console.log(..)`, выводя что-то вроде `{ index: 1 }`, так что в следующем операторе, когда `a.index++`, он изменяет что-то отличное от вывода `a` или сразу после него.\n\nВ большинстве случаев приведенный выше код, вероятно, будет создавать представление объекта в консоли инструментов разработчика, которое вы ожидаете. Но возможно, что этот же код может работать в ситуации, когда браузер считает необходимым отложить консольный ввод-вывод в фоновом режиме, и в этом случае *возможно*, что к тому времени, когда объект будет представлен в консоли браузера, ` a.index++` уже произошло, и он показывает `{ index: 2 }`.\n\nЭто движущаяся цель, при каких условиях именно «консольный» ввод-вывод будет отложен, или даже будет ли он наблюдаться. Просто имейте в виду эту возможную асинхронность в вводе/выводе на тот случай, если вы когда-нибудь столкнетесь с проблемами при отладке, когда объекты были изменены *после* оператора `console.log(..)`, и тем не менее вы видите неожиданные изменения.\n\n**Примечание.** Если вы столкнулись с этим редким случаем, лучше всего использовать точки останова в отладчике JS вместо того, чтобы полагаться на вывод консоли. Следующим лучшим вариантом было бы принудительно сделать «моментальный снимок» рассматриваемого объекта, сериализовав его в «строку», например, с «JSON.stringify(..)».\n\n## Цикл событий (Event Loop)\n\nДавайте сделаем (возможно, шокирующее) утверждение: несмотря на явное разрешение асинхронного кода JS (например, тайм-аут, который мы только что рассмотрели), до недавнего времени (ES6) сам JavaScript на самом деле никогда не имел прямого встроенного понятия асинхронности.\n\n**Что!?** Это кажется безумием, верно? На самом деле, это правда. Сам JS-движок никогда не делал ничего, кроме как выполнял один фрагмент вашей программы в любой момент, когда его об этом попросят.\n\n\"Попросят\" Кто? Это важная часть!\n\nДвижок JS не работает изолированно. Он работает внутри *среды хостинга*, которая для большинства разработчиков является типичным веб-браузером. За последние несколько лет (но не исключительно) JS расширился за пределы браузера в другие среды, такие как серверы, с помощью таких вещей, как Node.js. Фактически, в наши дни JavaScript внедряется во все виды устройств, от роботов до лампочек.\n\nНо один общий «поток» (это не очень тонкая асинхронная шутка, чего бы это ни стоило) всех этих сред заключается в том, что в них есть механизм, который обрабатывает выполнение нескольких фрагментов вашей программы *с течением времени*, в каждый момент времени. момент вызова JS-движка, называемый «циклом событий».\n\nДругими словами, движок JS не имеет врожденного чувства *времени*, а вместо этого является средой выполнения по требованию для любого произвольного фрагмента JS. Это окружающая среда, которая всегда *планирует* «события» (выполнения кода JS).\n\nТак, например, когда ваша программа JS делает запрос Ajax для получения некоторых данных с сервера, вы настраиваете код «ответа» в функции (обычно называемой «обратным вызовом»), и механизм JS сообщает среде хостинга, «Эй, я собираюсь приостановить выполнение на данный момент, но когда вы закончите с этим сетевым запросом, и у вас есть какие-то данные, *вызовите* эту функцию *назад*».\n\nЗатем браузер настраивается на прослушивание ответа из сети, и когда ему есть что вам дать, он планирует выполнение функции обратного вызова, вставляя ее в *цикл событий*.\n\nТак что же такое *цикл событий*?\n\nДавайте сначала концептуализируем это с помощью некоторого фальшивого кода:\n\n```js\n// `eventLoop` - это массив, который действует как очередь (первым пришел, первым ушел)\nvar eventLoop = [ ];\nvar event;\n\n// будет работать \"всегда\"\nwhile (true) {\n\t// выполняем \"такт\"\n\tif (eventLoop.length > 0) {\n\t\t// получаем следующее событие из очереди\n\t\tevent = eventLoop.shift();\n\n\t\t// теперь выполняем следующее событие\n\t\ttry {\n\t\t\tevent();\n\t\t}\n\t\tcatch (err) {\n\t\t\treportError(err);\n\t\t}\n\t}\n}\n```\n\nЭто, конечно, сильно упрощенный псевдокод для иллюстрации концепций. Но этого должно быть достаточно, чтобы помочь лучше понять.\n\nКак видите, существует непрерывно работающий цикл, представленный циклом while, и каждая итерация этого цикла называется «тактом». Для каждого такта, если событие ожидает в очереди, оно снимается и выполняется. Эти события являются обратными вызовами ваших функций.\n\nВажно отметить, что `setTimeout(..)` не помещает ваш обратный вызов в очередь цикла событий. Что он делает, так это устанавливает таймер; когда таймер истекает, среда помещает ваш обратный вызов в цикл событий, так что какой-то будущий такт подберет его и выполнит.\n\nЧто делать, если в этот момент в цикле событий уже 20 элементов? Ваш обратный вызов ждет. Он становится в очередь позади других — обычно нет пути для опережения очереди и пропуска вперед в очереди. Это объясняет, почему таймеры `setTimeout(..)` могут не срабатывать с идеальной временной точностью. Вам гарантируется (грубо говоря), что ваш обратный вызов не сработает *до* указанного вами временного интервала, но это может произойти в это время или позже, в зависимости от состояния очереди событий.\n\nТаким образом, другими словами, ваша программа обычно разбивается на множество небольших фрагментов, которые выполняются один за другим в очереди цикла событий. И технически, другие события, не связанные напрямую с вашей программой, также могут чередоваться в очереди.\n\n**Примечание.** Мы упоминали «до недавнего времени» в связи с тем, что ES6 изменил характер управления очередью цикла событий. В основном это формальная техническая особенность, но теперь ES6 определяет, как работает цикл обработки событий, что означает, что технически это находится в компетенции JS-движка, а не только *среды хостинга*. Одной из основных причин этого изменения является введение промисов ES6, которые мы обсудим в главе 3, потому что они требуют возможности иметь прямой, детальный контроль над операциями планирования в очереди цикла событий (см. обсуждение `setTimeout (..0)` в разделе \"Cooperation\").\n\n## Параллельная обработка\n\nОчень часто смешивают термины «асинхронный» и «параллельный», но на самом деле они совершенно разные. Помните, что асинхронность — это разрыв между *сейчас* и *позже*. Но параллель означает, что вещи могут происходить одновременно.\n\nНаиболее распространенными инструментами для параллельных вычислений являются процессы и потоки. Процессы и потоки выполняются независимо и могут выполняться одновременно: на разных процессорах или даже на разных компьютерах, но несколько потоков могут совместно использовать память одного процесса.\n\nЦикл событий, напротив, разбивает свою работу на задачи и выполняет их последовательно, запрещая параллельный доступ и изменения в разделяемой памяти. Параллелизм и «сериализм» могут сосуществовать в виде взаимодействующих циклов событий в отдельных потоках.\n\nЧередование параллельных потоков выполнения и чередование асинхронных событий происходит на очень разных уровнях детализации.\n\nНапример:\n\n```js\nfunction later() {\n\tanswer = answer * 2;\n\tconsole.log( \"Meaning of life:\", answer );\n}\n```\n\nВ то время как все содержимое `later()` будет рассматриваться как одна запись в очереди цикла событий, если подумать о потоке, в котором будет выполняться этот код, на самом деле существует, возможно, дюжина различных низкоуровневых операций. Например, `answer = answer * 2` требует сначала загрузить текущее значение `answer`, затем куда-то поместить `2`, затем выполнить умножение, затем взять результат и сохранить его обратно в `answer`.\n\nВ однопоточной среде на самом деле не имеет значения, что элементы в очереди потоков являются низкоуровневыми операциями, потому что ничто не может прервать поток. Но если у вас есть параллельная система, в которой два разных потока работают в одной и той же программе, вы, скорее всего, получите непредсказуемое поведение.\n\nРассмотрим:\n\n```js\nvar a = 20;\n\nfunction foo() {\n\ta = a + 1;\n}\n\nfunction bar() {\n\ta = a * 2;\n}\n\n// ajax(..) — это произвольная функция Ajax, заданная библиотекой\najax( \"http://some.url.1\", foo );\najax( \"http://some.url.2\", bar );\n```\n\nВ однопоточном поведении JavaScript, если `foo()` запускается до `bar()`, результатом будет то, что `a` имеет `42`, но если `bar()` запускается до `foo()`, результатом будет `a` будет `41`.\n\nЕсли бы события JS, совместно использующие одни и те же данные, выполнялись параллельно, проблемы были бы гораздо более тонкими. Рассмотрим эти два списка задач псевдокода как потоки, которые могли бы соответственно запускать код в `foo()` и `bar()`, и подумайте, что произойдет, если они будут выполняться точно в одно и то же время:\n\nПоток 1 («X» и «Y» — временные ячейки памяти):\n```\nfoo():\n а. загрузить значение `a` в `X`\n б. сохранить `1` в `Y`\n в. добавить `X` и `Y`, сохранить результат в `X`\n д. сохранить значение `X` в `a`\n```\n\nПоток 2 («X» и «Y» — временные ячейки памяти):\n```\nbar():\n а. загрузить значение `a` в `X`\n б. сохранить `2` в `Y`\n в. умножить `X` и `Y`, сохранить результат в `X`\n д. сохранить значение `X` в `a`\n```\n\nТеперь предположим, что два потока действительно выполняются параллельно. Вы, вероятно, можете определить проблему, верно? Они используют разделяемые ячейки памяти `X` и `Y` для своих временных шагов.\n\nКаков конечный результат в `a`, если шаги происходят так?\n\n```\n1a (загрузить значение `a` в `X` ==> `20`)\n2a (загрузить значение `a` в `X` ==> `20`)\n1b (сохранить `1` в `Y` ==> `1`)\n2b (сохранить `2` в `Y` ==> `2`)\n1c (добавьте `X` и `Y`, сохраните результат в `X` ==> `22`)\n1d (сохранить значение `X` в `a` ==> `22`)\n2c (умножить `X` и `Y`, сохранить результат в `X` ==> `44`)\n2d (сохранить значение `X` в `a` ==> `44`)\n```\n\nРезультатом в «а» будет «44». Но как быть с этим заказом?\n\n```\n1a (загрузить значение `a` в `X` ==> `20`)\n2a (загрузить значение `a` в `X` ==> `20`)\n2b (сохранить `2` в `Y` ==> `2`)\n1b (сохранить `1` в `Y` ==> `1`)\n2c (умножить `X` и `Y`, сохранить результат в `X` ==> `20`)\n1c (добавьте `X` и `Y`, сохраните результат в `X` ==> `21`)\n1d (сохранить значение `X` в `a` ==> `21`)\n2d (сохранить значение `X` в `a` ==> `21`)\n```\n\nРезультатом в «а» будет «21».\n\nТаким образом, многопоточное программирование очень сложно, потому что, если вы не предпримете специальных шагов для предотвращения такого прерывания/перемежения, вы можете получить очень неожиданное, недетерминированное поведение, которое часто приводит к головной боли.\n\nJavaScript никогда не делится данными между потоками, а это означает, что *этот* уровень недетерминизма не имеет значения. Но это не значит, что JS всегда детерминирован. Помните ранее, где относительное упорядочение `foo()` и `bar()` дает два разных результата (`41` или `42`)?\n\n**Примечание.** Возможно, это еще не очевидно, но не всякий недетерминизм плох. Иногда это неуместно, а иногда намеренно. Мы увидим больше примеров этого в этой и следующих нескольких главах.\n\n### Выполнить до завершения\n\nИз-за однопоточности JavaScript код внутри `foo()` (и `bar()`) является атомарным, что означает, что как только `foo()` запускается, весь его код завершится до того, как любой из кода в `bar()` начнет работать, и наоборот. Это называется поведением «запуск до завершения».\n\nНа самом деле семантика выполнения до завершения более очевидна, когда `foo()` и `bar()` содержат больше кода, например:\n\n```js\nvar a = 1;\nvar b = 2;\n\nfunction foo() {\n\ta++;\n\tb = b * a;\n\ta = b + 3;\n}\n\nfunction bar() {\n\tb--;\n\ta = 8 + b;\n\tb = a * 2;\n}\n\n// ajax(..) — это произвольная функция Ajax, заданная библиотекой\najax( \"http://some.url.1\", foo );\najax( \"http://some.url.2\", bar );\n```\n\nПоскольку `foo()` не может быть прервана `bar()`, а `bar()` не может быть прервана `foo()`, эта программа имеет только два возможных результата в зависимости от того, какой из них запустится первым: - если бы существовала многопоточность и отдельные операторы в `foo()` и `bar()` могли чередоваться, количество возможных результатов было бы значительно увеличено!\n\nБлок 1 является синхронным (происходит *сейчас*), но фрагменты 2 и 3 асинхронны (происходят *позже*), что означает, что их выполнение будет разделено временным промежутком.\n\nБлок 1:\n```js\nvar a = 1;\nvar b = 2;\n```\n\nБлок 2 (`foo()`):\n```js\na++;\nb = b * a;\na = b + 3;\n```\n\nБлок 3 (`bar()`):\n```js\nb--;\na = 8 + b;\nb = a * 2;\n```\n\nБлоки 2 и 3 могут выполняться в любом порядке, поэтому для этой программы есть два возможных результата, как показано здесь:\n\nВывод 1:\n```js\nvar a = 1;\nvar b = 2;\n\n// foo()\na++;\nb = b * a;\na = b + 3;\n\n// bar()\nb--;\na = 8 + b;\nb = a * 2;\n\na; // 11\nb; // 22\n```\n\nВывод 2:\n```js\nvar a = 1;\nvar b = 2;\n\n// bar()\nb--;\na = 8 + b;\nb = a * 2;\n\n// foo()\na++;\nb = b * a;\na = b + 3;\n\na; // 183\nb; // 180\n```\n\nДва результата одного и того же кода означают, что у нас все еще есть недетерминизм! Но это на уровне упорядочения функций (событий), а не на уровне упорядочения операторов (или, фактически, на уровне упорядочения операций выражений), как в случае с потоками. Другими словами, это *более детерминировано*, чем потоки.\n\nПрименительно к поведению JavaScript этот недетерминизм упорядочения функций является общим термином «состояние гонки», поскольку `foo()` и `bar()` соревнуются друг с другом, чтобы увидеть, какой из них запустится первым. В частности, это «состояние гонки», потому что вы не можете надежно предсказать, как окажутся «a» и «b».\n\n**Примечание:** Если бы в JS была функция, которая каким-то образом не имела бы поведения выполнения до завершения, у нас могло бы быть гораздо больше возможных результатов, верно? Оказывается, ES6 представляет именно такую вещь (см. главу 4 «Генераторы»), но не волнуйтесь прямо сейчас, мы еще вернемся к этому!\n\n## Конкурентность\n\nДавайте представим себе сайт, на котором отображается список обновлений статуса (например, лента новостей в социальной сети), который постепенно загружается по мере того, как пользователь прокручивает список вниз. Чтобы такая функция работала правильно, (по крайней мере) два отдельных «процесса» должны выполняться *одновременно* (т.е. в течение одного и того же промежутка времени, но не обязательно в один и тот же момент).\n\n**Примечание.** Мы используем здесь слово «процесс» в кавычках, потому что это не настоящие процессы уровня операционной системы с точки зрения информатики. Это виртуальные процессы или задачи, которые представляют собой логически связанные последовательные серии операций. Мы просто предпочтем «процесс», а не «задачу», потому что с точки зрения терминологии это будет соответствовать определениям изучаемых нами понятий.\n\nПервый «процесс» будет реагировать на события «onscroll» (запросы Ajax для нового контента), поскольку они срабатывают, когда пользователь прокручивает страницу дальше вниз. Второй «процесс» будет получать ответы Ajax (для отображения содержимого на странице).\n\nОчевидно, что если пользователь прокручивает страницу достаточно быстро, вы можете увидеть два или более события onscroll, запускаемых в течение времени, необходимого для получения и обработки первого ответа, и, таким образом, у вас будут события onscroll и события ответа Ajax, которые будут **конкурировать** друг с другом.\n\nКонкурентность — это когда два или более «процессов» выполняются одновременно в течение одного и того же периода, независимо от того, происходят ли их отдельные составляющие операции *параллельно* (в один и тот же момент на разных процессорах или ядрах) или нет. Тогда вы можете думать о конкурентности как о параллелизме на уровне «процесса» (или на уровне задачи), в отличие от параллелизма на уровне операций (потоки, исполняемые на отдельных процессорах).\n\n**Примечание.** Конкурентность также вводит необязательное понятие этих «процессов», взаимодействующих друг с другом. Мы вернемся к этому позже.\n\nДля данного окна времени (несколько секунд пользовательской прокрутки) давайте визуализируем каждый независимый «процесс» как серию событий/операций:\n\n\"Процесс\" 1 (`onscroll` events):\n```\nonscroll, request 1\nonscroll, request 2\nonscroll, request 3\nonscroll, request 4\nonscroll, request 5\nonscroll, request 6\nonscroll, request 7\n```\n\n\"Процесс\" 2 (Ajax response events):\n```\nresponse 1\nresponse 2\nresponse 3\nresponse 4\nresponse 5\nresponse 6\nresponse 7\n```\n\nВполне возможно, что событие `onscroll` и событие ответа Ajax могут быть готовы к обработке в один и тот же *момент*. Например, давайте визуализируем эти события на временной шкале:\n\n```\nonscroll, request 1\nonscroll, request 2 response 1\nonscroll, request 3 response 2\nresponse 3\nonscroll, request 4\nonscroll, request 5\nonscroll, request 6 response 4\nonscroll, request 7\nresponse 6\nresponse 5\nresponse 7\n```\n\nНо, возвращаясь к нашему представлению о цикле событий из предыдущей главы, JS сможет обрабатывать только одно событие за раз, поэтому либо `onscroll, request 2` будет происходить первым, либо `response 1` должно произойти первым, но они не могут произойти буквально в один и тот же момент. Так же, как дети в школьной столовой, независимо от того, какую толпу они образуют за дверью, им придется выстроиться в одну очередь, чтобы получить свой обед!\n\nДавайте визуализируем чередование всех этих событий в очереди цикла событий.\n\nОчередь цикла событий:\n```\nonscroll, request 1 <--- Процесс 1 начинается\nonscroll, request 2\nresponse 1 <--- Процесс 2 начинается\nonscroll, request 3\nresponse 2\nresponse 3\nonscroll, request 4\nonscroll, request 5\nonscroll, request 6\nresponse 4\nonscroll, request 7 <--- Процесс 1 заканчивается\nresponse 6\nresponse 5\nresponse 7 <--- Процесс 2 заканчивается\n```\n\n«Процесс 1» и «Процесс 2» выполняются одновременно (параллельно на уровне задач), но их отдельные события выполняются последовательно в очереди цикла событий.\n\nКстати, обратите внимание, как «ответ 6» и «ответ 5» вернулись не в том порядке, в котором ожидалось?\n\nОднопоточный цикл событий — это одно из проявлений конкурентности (конечно, есть и другие, к которым мы вернемся позже).\n\n### Не взаимодействующий\n\nПоскольку два или более «процессов» одновременно чередуют свои шаги/события одновременно внутри одной программы, им не обязательно взаимодействовать друг с другом, если задачи не связаны между собой. **Если они не взаимодействуют, недетерминизм вполне приемлем.**\n\nНапример:\n\n```js\nvar res = {};\n\nfunction foo(results) {\n\tres.foo = results;\n}\n\nfunction bar(results) {\n\tres.bar = results;\n}\n\najax( \"http://some.url.1\", foo );\najax( \"http://some.url.2\", bar );\n```\n\n`foo()` и `bar()` - это два конкурирующих \"процесса\", и нельзя однозначно определить в каком порядке они будут вызваны. Однако мы построили программу таким образом, что порядок их вызова не имеет значения, так как они работают независимо и, следовательно, не нуждаются во взаимодействии.\n\nЭто не ошибка «состояния гонки», так как код всегда будет работать правильно, независимо от порядка.\n\n### Взаимодействие\n\nЧаще всего, конкурирующие «процессы» будут по необходимости взаимодействовать косвенно через область видимости и/или DOM. Когда такое взаимодействие произойдет, вам необходимо координировать эти взаимодействия, чтобы предотвратить «состояние гонки», как описано ранее.\n\nВот простой пример двух конкурирующих «процессов», которые взаимодействуют из-за подразумеваемого порядка, который только *иногда нарушается*:\n\n```js\nvar res = [];\n\nfunction response(data) {\n\tres.push( data );\n}\n\najax( \"http://some.url.1\", response );\najax( \"http://some.url.2\", response );\n```\n\nКонкурирующие «процессы» — это два вызова `response()`, которые будут выполняться для обработки ответов Ajax. Они могут происходить в любом порядке.\n\nПредположим, ожидаемое поведение состоит в том, что `res[0]` имеет результаты вызова `\"http://some.url.1\"`, а `res[1]` имеет результаты `\"http:/ /some.url.2\"` вызов. Иногда это будет иметь место, но иногда они будут перевернуты, в зависимости от того, какой вызов завершится первым. Существует довольно большая вероятность того, что этот недетерминизм является ошибкой «состояния гонки».\n\n**Примечание.** Будьте крайне осторожны с предположениями, которые вы можете делать в подобных ситуациях. Например, разработчик нередко замечает, что «http://some.url.2» «всегда» отвечает намного медленнее, чем «http://some.url.1», возможно, из-за в силу того, какие задачи они выполняют (например, одна выполняет задачу базы данных, а другая просто извлекает статический файл), поэтому наблюдаемый порядок всегда выглядит так, как ожидалось. Даже если оба запроса отправляются на один и тот же сервер, и *он* намеренно отвечает в определенном порядке, нет *реальной* гарантии того, в каком порядке ответы будут возвращены в браузер.\n\nТаким образом, для устранения такого состояния гонки вы можете координировать порядок взаимодействий:\n\n```js\nvar res = [];\n\nfunction response(data) {\n\tif (data.url == \"http://some.url.1\") {\n\t\tres[0] = data;\n\t}\n\telse if (data.url == \"http://some.url.2\") {\n\t\tres[1] = data;\n\t}\n}\n\najax( \"http://some.url.1\", response );\najax( \"http://some.url.2\", response );\n```\n\nНезависимо от того, какой ответ Ajax возвращается первым, мы проверяем `data.url` (предполагая, что он возвращен с сервера, конечно!), чтобы выяснить, какую позицию данные ответа должны занимать в массиве `res`. `res[0]` всегда будет содержать результаты `\"http://some.url.1\"`, а `res[1]` всегда будет содержать результаты `\"http://some.url.2\"`. Путем простой координации мы устранили недетерминизм «состояния гонки».\n\nТе же рассуждения из этого сценария применимы, если несколько конкурирующих вызовов функций взаимодействуют друг с другом через общую модель DOM, например, один обновляет содержимое `