Как реализовать функцию паузы в Node.js

Чтобы реализовать паузу или ожидание в Node.js JavaScript без колбэков, можно использовать async/await с пользовательской функцией sleep, которая возвращает промис. Такой подход позволяет писать код, выглядящий синхронным, при этом сохраняя неблокирующую природу Node.js, и позволяет последующему коду выполняться после заданной задержки без использования колбэков.

Contents

• Создание пользовательской функции sleep
• Использование async/await для пауз
• Лучшие практики и соображения
• Альтернативные подходы
• Полный рабочий пример

Создание пользовательской функции sleep

Основа реализации паузы в Node.js без колбэков — создание пользовательской функции sleep, которая возвращает промис. Такой подход оборачивает асинхронную функцию setTimeout в промис, позволяя использовать await для приостановки выполнения.

// Определяем функцию sleep, которая возвращает промис
function sleep(ms) {
  return new Promise((resolve) => setTimeout(resolve, ms));
}

Эта простая функция создаёт новый промис, который разрешается после указанного количества миллисекунд, фактически создавая механизм задержки, который можно использовать с синтаксисом async/await. Согласно Mastering JS, «Вы можете использовать async/await с промисами, чтобы задержать выполнение без колбэков».

Использование async/await для пауз

После того как у вас есть функция sleep, вы можете использовать её внутри асинхронной функции, чтобы создать паузы в потоке вашего кода. Ключевое слово await приостанавливает выполнение текущей асинхронной функции до тех пор, пока промис не будет разрешён, давая вам поведение, похожее на синхронный код.

async function myScript() {
  console.log('Welcome to my console,');
  
  await sleep(10000); // Ожидание 10 секунд
  
  console.log('Blah blah blah blah extra‑blah');
}

Как объясняется в документации MDN, «Поскольку await допустим только внутри async функций и модулей, которые сами по себе асинхронны и возвращают промисы, выражение await никогда не блокирует основной поток и только отложит выполнение кода, который действительно зависит от результата».

Почему этот подход работает

Хотя это выглядит как приостановка выполнения, важно понять, что Node.js остаётся неблокирующим. Ключевое слово await приостанавливает выполнение только внутри конкретной асинхронной функции, позволяя другим операциям продолжать работу в цикле событий. Именно поэтому этот подход идеален для консольных скриптов и подобных приложений.

Лучшие практики и соображения

При реализации задержек в Node.js учтите следующие важные практики:

1. Всегда используйте асинхронные функции

Функция паузы должна вызываться внутри асинхронной функции, поскольку await допустим только в таком контексте.

// ❌ Это не сработает
function regularFunction() {
  await sleep(1000); // SyntaxError
}

// ✅ Это работает
async function asyncFunction() {
  await sleep(1000);
}

2. Обрабатывайте ошибки должным образом

Оборачивайте вызовы await в блоки try‑catch, чтобы обрабатывать возможные ошибки:

async function myScript() {
  try {
    console.log('Starting...');
    await sleep(5000);
    console.log('After 5 seconds');
  } catch (error) {
    console.error('Error during delay:', error);
  }
}

3. Будьте внимательны к циклу событий

Как отмечает Zignuts Technology, «для неблокирующих задержек, идеальных для ограничения скорости и тестирования» – этот подход идеально подходит для сценариев, где нужно приостановить выполнение без блокировки всего приложения.

Альтернативные подходы

Хотя подход с async/await рекомендуется, существуют и другие варианты, которые вы можете рассмотреть:

1. Использование метода util.promisify

Вы можете напрямую преобразовать setTimeout в промис:

const util = require('util');
const sleep = util.promisify(setTimeout);

async function myScript() {
  console.log('Welcome to my console,');
  await sleep(10000);
  console.log('Blah blah blah blah extra‑blah');
}

2. Использование сторонних библиотек

Для более продвинутых случаев можно рассмотреть библиотеки, такие как wait или delay:

npm install wait

const wait = require('wait').default;

async function myScript() {
  console.log('Welcome to my console,');
  await wait(10); // Ожидание 10 секунд
  console.log('Blah blah blah blah extra‑blah');
}

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

Полный рабочий пример

Ниже приведён полный консольный скрипт, демонстрирующий, как реализовать паузу в 10 секунд:

// Определяем функцию sleep, которая возвращает промис
function sleep(ms) {
  return new Promise((resolve) => setTimeout(resolve, ms));
}

// Основная функция скрипта
async function runScript() {
  console.log('Welcome to my console,');
  console.log('This message appears immediately.');
  
  console.log('Pausing for 10 seconds...');
  await sleep(10000); // Ожидание 10 секунд
  
  console.log('Blah blah blah blah extra‑blah');
  console.log('This message appears after the delay.');
}

// Запускаем скрипт
runScript().catch(console.error);

Чтобы запустить скрипт, сохраните его как pause-example.js и выполните:

node pause-example.js

Вывод будет выглядеть так:

1. “Welcome to my console,”
2. “This message appears immediately.”
3. “Pausing for 10 seconds…”
4. (10‑секундная пауза)
5. “Blah blah blah blah extra‑blah”
6. “This message appears after the delay.”

Как показано в руководстве BrowserStack, «SetTimeout() можно обернуть в Promise и использовать с async/await, чтобы заморозить выполнение и сделать его «блокирующим»» – именно то, что мы реализовали здесь.

Источники

1. How can I wait In Node.js (JavaScript)? - Stack Overflow
2. Sleep in NodeJS - Mastering JS
3. How to Make JavaScript Wait for 1 Second: Using setTimeout and Promises? - BrowserStack
4. await - JavaScript | MDN
5. Nodejs Sleep Function: Pause for a Period of Time - Zignuts Technology
6. How to create a sleep or delay in Node.js - byby.dev
7. Async/await - JavaScript.info

Заключение

Реализация паузы или функции ожидания в Node.js без колбэков проста с использованием async/await и пользовательской функции sleep. Ключевые выводы:

1. Создайте функцию sleep, которая возвращает промис, оборачивая setTimeout.
2. Используйте await внутри асинхронной функции, чтобы приостановить выполнение.
3. Такой подход обеспечивает синхронный вид кода при сохранении неблокирующей природы Node.js.
4. Всегда обрабатывайте ошибки с помощью try‑catch при работе с асинхронными операциями.
5. Этот метод идеален для консольных скриптов, тестирования и сценариев, требующих контролируемых задержек.

Для ваших консольных скриптов пользовательская функция sleep будет работать идеально, позволяя писать чистый, читаемый код с естественным управлением потоком и достигать нужной функциональности паузы.