Теория: Возврат в асинхронном коде

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

import fs from 'fs'

const noop = () => {}
const content = fs.readFile('./myfile', 'utf-8', noop)
console.log(content) // undefined

И единственный способ получить результат — описать логику в колбеке. Тогда возникает вопрос: а что, если сделать return внутри колбека? К чему это приведёт?

import fs from 'fs'

const content = fs.readFile('./myfile', 'utf-8', (_error, data) => {
  // что-нибудь делаем
  return data
})
console.log(content) // undefined

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

import fs from 'fs'

const content = fs.readFile('./myfile', 'utf-8', (_error, data) => {
  if (data === '') {
    return
  }
  // делаем что-нибудь с данными
})
console.log(content) // undefined

Этот паттерн называется guard expression.

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

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

import fs from 'fs'

const readFileWithTrim = (filepath, cb) => {
  fs.readFile(filepath, 'utf-8', (_error, data) => {
    // При вызове колбек-функции передаем null первым параметром
    // Поскольку обработку ошибок мы пока не рассматриваем
    cb(null, data.trim())
  })
}

readFileWithTrim('./myfile', (_error, data) => console.log(data))

Этот процесс рекурсивен по своей природе, любая функция, которая внутри работает с асинхронной функцией, становится асинхронной и начинает принимать на вход колбек. Почему так происходит? Почему нельзя просто выполнить асинхронную операцию внутри, никак не сообщая об этом наружу? Дело в том, что в такой ситуации вы не можете ни воспользоваться результатом работы асинхронной функции (ведь данные приходят в колбек в другом стеке вызовов), ни узнать о том, закончилась ли операция вообще и закончилась ли она успешно. Всё это рассмотрим в следующих уроках.