Отмена устаревания

Иногда устаревание API может быть отменено. В таких ситуациях этот документ будет обновлен с соответствующей информацией. Однако идентификатор устаревания не будет изменён.

Список устаревших API

DEP0001: http.OutgoingMessage.prototype.flush

Тип: Достигнут конец жизненного цикла

OutgoingMessage.prototype.flush() был удалён. Используйте OutgoingMessage.prototype.flushHeaders() вместо него.

DEP0002: require('_linklist')

Тип: Достигнут конец жизненного цикла

Модуль _linklist устарел. Пожалуйста, используйте альтернативу на уровне пользователя.

DEP0003: _writableState.buffer

Тип: Достигнут конец жизненного цикла

_writableState.buffer был удалён. Используйте _writableState.getBuffer() вместо него.

DEP0004: CryptoStream.prototype.readyState

Тип: Достигнут конец жизненного цикла

Свойство CryptoStream.prototype.readyState было удалено.

DEP0005: Buffer() конструктор

Тип: Выполнение (поддерживает --pending-deprecation)

Функция Buffer() и конструктор new Buffer() устарели из-за проблем с удобством использования API, которые могут привести к случайным проблемам безопасности.

В качестве альтернативы используйте один из следующих способов создания объектов Buffer:

• Buffer.alloc(size[, fill[, encoding]]): Создать Buffer с инициализированной памятью.
• Buffer.allocUnsafe(size): Создать Buffer с неинициализированной памятью.
• Buffer.allocUnsafeSlow(size): Создать Buffer с неинициализированной памятью.
• Buffer.from(array): Создать Buffer с копией array
• Buffer.from(arrayBuffer[, byteOffset[, length]]) - Создать Buffer, который оборачивает указанный arrayBuffer.
• Buffer.from(buffer): Создать Buffer, который копирует buffer.
• Buffer.from(string[, encoding]): Создать Buffer, который копирует string.

Без --pending-deprecation, предупреждения о выполнении появляются только для кода, не находящегося в node_modules. Это означает, что предупреждений об устаревании для использования Buffer() в зависимостях не будет. С --pending-deprecation, предупреждение о выполнении появляется независимо от того, где используется Buffer().

DEP0006: child_process options.customFds

Тип: Достигнут конец жизненного цикла

В модуле child_process методы spawn(), fork(), и exec() параметр options.customFds устарел. Вместо него следует использовать параметр options.stdio.

DEP0007: Заменить cluster worker.suicide на worker.exitedAfterDisconnect

Тип: Достигнут конец жизненного цикла

В более ранней версии Node.js cluster, в объект Worker было добавлено булево свойство с именем suicide. Целью этого свойства было указать, как и почему экземпляр Worker завершился. В Node.js 6.0.0 старое свойство устарело и было заменено новым свойством worker.exitedAfterDisconnect. Старое имя свойства неточно описывало реальную семантику и было излишне эмоционально окрашено.

DEP0008: require('constants')

Тип: Устаревание только в документации

Модуль constants устарел. При необходимости получить доступ к константам, относящимся к определённым встроенным модулям Node.js, разработчики должны вместо этого обратиться к свойству constants, экспонируемому соответствующим модулем. Например, require('fs').constants и require('os').constants.

DEP0009: crypto.pbkdf2 без digest

Тип: Достигнут конец жизненного цикла

Использование API crypto.pbkdf2() без указания digest было устаревшим в Node.js 6.0, поскольку метод по умолчанию использовал нерекомендуемый digest 'SHA1'. Раньше печаталось предупреждение об устаревании. Начиная с Node.js 8.0.0, вызов crypto.pbkdf2() или crypto.pbkdf2Sync() с digest установленным в undefined приведет к выбросу TypeError.

Начиная с Node.js v11.0.0, вызов этих функций с digest установленным в null будет печатать предупреждение об устаревании, чтобы соответствовать поведению, когда digest равно undefined.

Однако, передача undefined или null теперь приведёт к выбросу TypeError.

DEP0010: crypto.createCredentials

Тип: Достигнут конец жизненного цикла

API crypto.createCredentials() был удалён. Пожалуйста, используйте tls.createSecureContext() вместо него.

DEP0011: crypto.Credentials

Тип: Достигнут конец жизненного цикла

Класс crypto.Credentials был удалён. Пожалуйста, используйте tls.SecureContext вместо него.

DEP0012: Domain.dispose

Тип: Достигнут конец жизненного цикла

Domain.dispose() был удалён. Явно восстанавливайтесь от неудачных операций ввода-вывода, используя обработчики событий об ошибках, установленные в области.

DEP0013: fs асинхронная функция без обратного вызова

Тип: Достигнут конец жизненного цикла

Вызов асинхронной функции без обратного вызова вызывает TypeError в Node.js 10.0.0 и более поздних версиях. См. https://github.com/nodejs/node/pull/12562.

DEP0014: fs.read устаревший интерфейс String

Тип: Достигнут предел жизненного цикла

Интерфейс legacy fs.read() устарел. Используйте API Buffer, как указано в документации.

DEP0015: fs.readSync устаревший интерфейс String

Тип: Достигнут предел жизненного цикла

Интерфейс legacy fs.readSync() устарел. Используйте API Buffer, как указано в документации.

DEP0016: GLOBAL/root

Тип: Достигнут предел жизненного цикла

Алиасы GLOBAL и root для свойства global устарели в Node.js 6.0.0 и с тех пор были удалены.

DEP0017: Intl.v8BreakIterator

Тип: Достигнут предел жизненного цикла

Intl.v8BreakIterator была нестандартной расширением и была удалена. См. Intl.Segmenter.

DEP0018: Необработанные отклонения обещаний

Тип: Достигнут предел жизненного цикла

Необработанные отклонения обещаний устарели. По умолчанию отклонения обещаний, которые не обрабатываются, завершают процесс Node.js с ненулевым кодом выхода. Чтобы изменить способ обработки Node.js необработанных отклонений, используйте командную опцию --unhandled-rejections.

DEP0019: require('.') разрешён за пределами каталога

Тип: Достигнут предел жизненного цикла

В некоторых случаях require('.') мог разрешаться за пределами каталога пакета. Это поведение было удалено.

DEP0020: Server.connections

Тип: Достигнут предел жизненного цикла

Свойство Server.connections устарело в Node.js v0.9.7 и было удалено. Используйте метод Server.getConnections() вместо него.

DEP0021: Server.listenFD

Тип: Достигнут предел жизненного цикла

Метод Server.listenFD() был устарел и удален. Используйте Server.listen({fd: <number>}) вместо него.

DEP0022: os.tmpDir()

Тип: Достигнут предел жизненного цикла

API os.tmpDir() был устарел в Node.js 7.0.0 и с тех пор был удален. Используйте os.tmpdir() вместо него.

DEP0023: os.getNetworkInterfaces()

Тип: Достигнут предел жизненного цикла

Метод os.getNetworkInterfaces() устарел. Используйте метод os.networkInterfaces() вместо него.

DEP0024: REPLServer.prototype.convertToContext()

Тип: Достигнут предел жизненного цикла

API REPLServer.prototype.convertToContext() был удален.

DEP0025: require('sys')

Тип: Режим выполнения

Модуль sys устарел. Используйте модуль util вместо него.

DEP0026: util.print()

Тип: Достигнут предел жизненного цикла

util.print() был удалён. Используйте console.log() вместо него.

DEP0027: util.puts()

Тип: Достигнут предел жизненного цикла

util.puts() был удалён. Используйте console.log() вместо него.

DEP0028: util.debug()

Тип: Достигнут предел жизненного цикла

util.debug() был удалён. Используйте console.error() вместо него.

DEP0029: util.error()

Тип: Достигнут предел жизненного цикла

util.error() был удалён. Используйте console.error() вместо него.

DEP0030: SlowBuffer

Тип: Устаревание только в документации

Класс SlowBuffer устарел. Используйте Buffer.allocUnsafeSlow(size) вместо него.

DEP0031: ecdh.setPublicKey()

Тип: Устаревание только в документации

Метод ecdh.setPublicKey() теперь устарел, так как его включение в API бесполезно.

DEP0032: domain модуль

Тип: Устаревание только в документации

Модуль domain устарел и его использование не рекомендуется.

DEP0033: EventEmitter.listenerCount()

Тип: Только в документации

API events.listenerCount(emitter, eventName) устарел. Используйте вместо него emitter.listenerCount(eventName).

DEP0034: fs.exists(path, callback)

Тип: Только в документации

API fs.exists(path, callback) устарел. Используйте вместо него fs.stat() или fs.access().

DEP0035: fs.lchmod(path, mode, callback)

Тип: Только в документации

API fs.lchmod(path, mode, callback) устарел.

DEP0036: fs.lchmodSync(path, mode)

Тип: Только в документации

API fs.lchmodSync(path, mode) устарел.

DEP0037: fs.lchown(path, uid, gid, callback)

Тип: Устаревание отменено

API fs.lchown(path, uid, gid, callback) был устаревшим. Устаревание отменено, так как необходимые вспомогательные API были добавлены в libuv.

DEP0038: fs.lchownSync(path, uid, gid)

Тип: Устаревание отменено

API fs.lchownSync(path, uid, gid) был устаревшим. Устаревание отменено, так как необходимые вспомогательные API были добавлены в libuv.

DEP0039: require.extensions

Тип: Только в документации

Свойство require.extensions устарело.

DEP0040: punycode модуль

Тип: Только в документации (поддерживает --pending-deprecation)

Модуль punycode устарел. Используйте альтернативный пользовательский вариант.

DEP0041: NODE_REPL_HISTORY_FILE переменная среды

Тип: Конец жизненного цикла

Переменная среды NODE_REPL_HISTORY_FILE была удалена. Используйте NODE_REPL_HISTORY вместо неё.

DEP0042: tls.CryptoStream

Тип: Конец жизненного цикла

Класс tls.CryptoStream был удалён. Используйте tls.TLSSocket вместо него.

DEP0043: tls.SecurePair

Тип: Только в документации

Класс tls.SecurePair устарел. Используйте tls.TLSSocket вместо него.

DEP0044: util.isArray()

Тип: Только в документации

API util.isArray() устарел. Используйте Array.isArray() вместо него.

DEP0045: util.isBoolean()

Тип: Только в документации

API util.isBoolean() устарел.

DEP0046: util.isBuffer()

Тип: Только в документации

API util.isBuffer() устарел. Используйте Buffer.isBuffer() вместо него.

DEP0047: util.isDate()

Тип: Только в документации

API util.isDate() устарел.

DEP0048: util.isError()

Тип: Только в документации

API util.isError() устарел.

DEP0049: util.isFunction()

Тип: Только в документации

API util.isFunction() устарел.

DEP0050: util.isNull()

Тип: Только в документации

API util.isNull() устарел.

DEP0051: util.isNullOrUndefined()

Тип: Только в документации

API util.isNullOrUndefined() устарел.

DEP0052: util.isNumber()

Тип: Только в документации

API util.isNumber() устарело.

DEP0053: util.isObject()

Тип: Только в документации

API util.isObject() устарело.

DEP0054: util.isPrimitive()

Тип: Только в документации

API util.isPrimitive() устарело.

DEP0055: util.isRegExp()

Тип: Только в документации

API util.isRegExp() устарело.

DEP0056: util.isString()

Тип: Только в документации

API util.isString() устарело.

DEP0057: util.isSymbol()

Тип: Только в документации

API util.isSymbol() устарело.

DEP0058: util.isUndefined()

Тип: Только в документации

API util.isUndefined() устарело.

DEP0059: util.log()

Тип: Только в документации

API util.log() устарело.

DEP0060: util._extend()

Тип: Только в документации

API util._extend() устарело.

DEP0061: fs.SyncWriteStream

Тип: Конец жизненного цикла

Класс fs.SyncWriteStream никогда не предназначался для использования в качестве общедоступного API и был удалён. Альтернативный API недоступен. Используйте альтернативу в пользовательском пространстве.

DEP0062: node --debug

Тип: Конец жизненного цикла

--debug активирует устаревший интерфейс отладчика V8, который был удалён начиная с V8 5.8. Его заменил Inspector, который активируется с помощью --inspect.

DEP0063: ServerResponse.prototype.writeHeader()

Тип: Только в документации

API модуля http ServerResponse.prototype.writeHeader() устарело. Используйте ServerResponse.prototype.writeHead().

Метод ServerResponse.prototype.writeHeader() никогда не был задокументирован как официально поддерживаемый API.

DEP0064: tls.createSecurePair()

Тип: Выполнение

API tls.createSecurePair() было устарело в документации в Node.js 0.11.3. Пользователи должны использовать tls.Socket.

DEP0065: repl.REPL_MODE_MAGIC и NODE_REPL_MODE=magic

Тип: Конец жизненного цикла

Константа модуля repl REPL_MODE_MAGIC, используемая для опции replMode, была удалена. Её поведение было функционально идентичным поведению REPL_MODE_SLOPPY начиная с Node.js 6.0.0, когда был импортирован V8 5.0. Используйте REPL_MODE_SLOPPY.

Переменная среды NODE_REPL_MODE используется для установки базового replMode интерактивного сеанса node. Его значение, magic, также удалено. Используйте sloppy.

DEP0066: OutgoingMessage.prototype._headers, OutgoingMessage.prototype._headerNames

Тип: Выполнение

Свойства модуля http OutgoingMessage.prototype._headers и OutgoingMessage.prototype._headerNames устарели. Используйте один из общедоступных методов (например, OutgoingMessage.prototype.getHeader(), OutgoingMessage.prototype.getHeaders(), OutgoingMessage.prototype.getHeaderNames(), OutgoingMessage.prototype.getRawHeaderNames(), OutgoingMessage.prototype.hasHeader(), OutgoingMessage.prototype.removeHeader(), OutgoingMessage.prototype.setHeader()) для работы с исходящими заголовками.

Свойства OutgoingMessage.prototype._headers и OutgoingMessage.prototype._headerNames никогда не были задокументированы как официально поддерживаемые свойства.

DEP0067: OutgoingMessage.prototype._renderHeaders

Тип: Только в документации

API модуля http OutgoingMessage.prototype._renderHeaders() устарело.

Свойство OutgoingMessage.prototype._renderHeaders никогда не было задокументировано как официально поддерживаемый API.

DEP0068: node debug

Тип: Конец жизненного цикла

node debug соответствует устаревшему командному отладчику, который был заменён отладчиком CLI на основе V8 Inspector, доступным через node inspect.

DEP0069: vm.runInDebugContext(string)

Тип: Конец жизненного цикла

DebugContext был удалён в V8 и недоступен в Node.js 10+.

DebugContext — это экспериментальный API.

DEP0070: async_hooks.currentId()

Тип: Конец жизненного цикла

async_hooks.currentId() было переименовано в async_hooks.executionAsyncId() для ясности.

Это изменение было произведено, когда async_hooks был экспериментальным API.

DEP0071: async_hooks.triggerId()

Тип: Достиг конец жизненного цикла

async_hooks.triggerId() было переименовано в async_hooks.triggerAsyncId() для большей ясности.

Это изменение было внесено, пока async_hooks являлся экспериментальным API.

DEP0072: async_hooks.AsyncResource.triggerId()

Тип: Достиг конец жизненного цикла

async_hooks.AsyncResource.triggerId() было переименовано в async_hooks.AsyncResource.triggerAsyncId() для большей ясности.

Это изменение было внесено, пока async_hooks являлся экспериментальным API.

DEP0073: Несколько внутренних свойств net.Server

Тип: Достиг конец жизненного цикла

Доступ к нескольким внутренним, не документированным свойствам экземпляров net.Server с неподходящими именами устарел.

Поскольку исходный API не был документирован и не был полезен для кода вне ядра, замены API не предоставляется.

DEP0074: REPLServer.bufferedCommand

Тип: Достиг конец жизненного цикла

Свойство REPLServer.bufferedCommand устарело в пользу REPLServer.clearBufferedCommand().

DEP0075: REPLServer.parseREPLKeyword()

Тип: Достиг конец жизненного цикла

REPLServer.parseREPLKeyword() было удалено из пользовательского пространства.

DEP0076: tls.parseCertString()

Тип: Временное

tls.parseCertString() — это вспомогательная функция тривиального парсинга, которая была случайно опубликована. Эту функцию обычно можно заменить на:

const querystring = require('querystring');
querystring.parse(str, '\n', '=');

Эта функция не полностью эквивалентна querystring.parse(). Одно отличие заключается в том, что querystring.parse() выполняет декодирование URL:

> querystring.parse('%E5%A5%BD=1', '\n', '=');
{ '好': '1' }
> tls.parseCertString('%E5%A5%BD=1');
{ '%E5%A5%BD': '1' }

DEP0077: Module._debug()

Тип: Временное

Module._debug() устарело.

Функция Module._debug() никогда не была документирована как официально поддерживаемый API.

DEP0078: REPLServer.turnOffEditorMode()

Тип: Достиг конец жизненного цикла

REPLServer.turnOffEditorMode() было удалено из пользовательского пространства.

DEP0079: Функция пользовательской инспекции объектов через .inspect()

Тип: Достиг конец жизненного цикла

Использование свойства с именем inspect в объекте для указания пользовательской функции инспекции для util.inspect() устарело. Используйте util.inspect.custom вместо этого. Для обратной совместимости с Node.js до версии 6.4.0 можно указать оба.

DEP0080: path._makeLong()

Тип: Только в документации

Внутренний path._makeLong() не предназначался для общего использования. Однако модули пользовательского пространства нашли его полезным. Внутренний API устарел и заменён идентичным общедоступным методом path.toNamespacedPath().

DEP0081: fs.truncate() с использованием дескриптора файла

Тип: Временное

fs.truncate() fs.truncateSync() использование с дескриптором файла устарело. Пожалуйста, используйте fs.ftruncate() или fs.ftruncateSync() для работы с дескрипторами файлов.

DEP0082: REPLServer.prototype.memory()

Тип: Достиг конец жизненного цикла

REPLServer.prototype.memory() необходим только для внутренних механизмов самого REPLServer. Не используйте эту функцию.

DEP0083: Отключение ECDH путём установки ecdhCurve в false

Тип: Достиг конец жизненного цикла.

Параметр ecdhCurve для tls.createSecureContext() и tls.TLSSocket можно установить в false для полного отключения ECDH только на сервере. Этот режим устарел в преддверии миграции на OpenSSL 1.1.0 и согласованности с клиентом и теперь не поддерживается. Используйте параметр ciphers вместо этого.

DEP0084: требование связанных внутренних зависимостей

Тип: Достиг конец жизненного цикла

Начиная с версий Node.js 4.4.0 и 5.2.0, несколько модулей, предназначенных только для внутреннего использования, были ошибочно представлены в коде пользователя через require(). Эти модули были:

• v8/tools/codemap
• v8/tools/consarray
• v8/tools/csvparser
• v8/tools/logreader
• v8/tools/profile_view
• v8/tools/profile
• v8/tools/SourceMap
• v8/tools/splaytree
• v8/tools/tickprocessor-driver
• v8/tools/tickprocessor
• node-inspect/lib/_inspect (с 7.6.0)
• node-inspect/lib/internal/inspect_client (с 7.6.0)
• node-inspect/lib/internal/inspect_repl (с 7.6.0)

Модули v8/* не имеют экспортов и, если их не импортировать в определённом порядке, будут вызывать ошибки. Поэтому для их импорта через require() практически нет законных случаев.

С другой стороны, node-inspect может быть установлен локально через менеджер пакетов, так как он опубликован в реестре npm под тем же именем. Для этого не требуется модификация исходного кода.

DEP0085: Чувствительный API AsyncHooks

Тип: Достиг конец жизненного цикла

Чувствительный API AsyncHooks никогда не документировался и имел различные незначительные проблемы. Используйте API AsyncResource вместо него. См. https://github.com/nodejs/node/issues/15572.

DEP0086: Удалить runInAsyncIdScope

Тип: Достиг конец жизненного цикла

runInAsyncIdScope не отправляет событие 'before' или 'after' и, таким образом, может вызывать множество проблем. См. https://github.com/nodejs/node/issues/14328.

DEP0089: require('assert')

Тип: Устаревание отменено

Импорт assert напрямую не рекомендовался, поскольку экспонированные функции используют нестрогие проверки равенства. Устаревание было отменено, потому что использование модуля assert не запрещено, а устаревание вызвало путаницу у разработчиков.

DEP0090: Некорректные длины тегов аутентификации GCM

Тип: Достиг конец жизненного цикла

Node.js использовался для поддержки всех длин тегов аутентификации GCM, которые принимаются OpenSSL при вызове decipher.setAuthTag(). Начиная с Node.js v11.0.0, разрешены только длины тегов аутентификации 128, 120, 112, 104, 96, 64 и 32 бита. Теги аутентификации других длин недействительны в соответствии с NIST SP 800-38D.

DEP0091: crypto.DEFAULT_ENCODING

Тип: Выполнение

Свойство crypto.DEFAULT_ENCODING устарело.

DEP0092: Глобальное this привязанное к module.exports

Тип: Только в документации

Присваивание свойств глобальному this в качестве альтернативы module.exports устарело. Разработчики должны использовать exports или module.exports вместо этого.

DEP0093: crypto.fips устарело и заменено

Тип: Только в документации

Свойство crypto.fips устарело. Пожалуйста, используйте crypto.setFips() и crypto.getFips() вместо этого.

DEP0094: Использование assert.fail() с более чем одним аргументом

Тип: Выполнение

Использование assert.fail() с более чем одним аргументом устарело. Используйте assert.fail() с одним аргументом или используйте другой метод модуля assert.

DEP0095: timers.enroll()

Тип: Выполнение

timers.enroll() устарело. Пожалуйста, используйте публично документированные setTimeout() или setInterval() вместо этого.

DEP0096: timers.unenroll()

Тип: Выполнение

timers.unenroll() устарело. Пожалуйста, используйте публично документированные clearTimeout() или clearInterval() вместо этого.

DEP0097: MakeCallback с domain свойством

Тип: Выполнение

Пользователи MakeCallback, которые добавляют свойство domain для переноса контекста, должны начать использовать вариант async_context MakeCallback или CallbackScope, или высокоуровневый класс AsyncResource.

DEP0098: AsyncHooks встраиваемый AsyncResource.emitBefore и AsyncResource.emitAfter API

Тип: Конец жизненного цикла

Встраиваемый API AsyncHooks предоставляет методы .emitBefore() и .emitAfter(), которые очень легко использовать неправильно, что может привести к необратимым ошибкам.

Используйте вместо этого API asyncResource.runInAsyncScope(), который предоставляет гораздо более безопасную и удобную альтернативу. См. https://github.com/nodejs/node/pull/18513.

DEP0099: Async контекстно-независимые node::MakeCallback C++ API

Тип: Устаревание на этапе компиляции

Некоторые версии API node::MakeCallback доступны для модулей нативных модулей устарели. Используйте версии API, которые принимают параметр async_context.

DEP0100: process.assert()

Тип: Выполнение

process.assert() устарело. Пожалуйста, используйте модуль assert вместо него.

Эта функция никогда не была задокументирована.

DEP0101: --with-lttng

Тип: Конец жизненного цикла

Параметр компиляции --with-lttng был удален.

DEP0102: Использование noAssert в операциях Buffer#(read|write)

Тип: Конец жизненного цикла

Использование аргумента noAssert больше не имеет функциональности. Все входные данные будут проверены независимо от того, установлено ли оно в true или нет. Пропуск проверки может привести к трудно обнаруживаемым ошибкам и сбоям.

DEP0103: process.binding('util').is[...] проверки типов

Тип: Только в документации (поддерживает --pending-deprecation)

Использование process.binding() в целом следует избегать. Методы проверки типов в частности могут быть заменены использованием util.types.

Это устаревание было заменено устареванием API process.binding() (DEP0111).

DEP0104: process.env приведение строк

Тип: Только в документации (поддерживает --pending-deprecation)

При присваивании нестрокового свойства process.env, присваиваемое значение неявно преобразуется в строку. Это поведение устарело, если присваиваемое значение не является строкой, булевым значением или числом. В будущем такое присваивание может привести к ошибке. Пожалуйста, преобразуйте свойство в строку перед присваиванием его process.env.

DEP0105: decipher.finaltol

Тип: Конец жизненного цикла

decipher.finaltol() никогда не документировался и был псевдонимом для decipher.final(). Этот API был удален, и рекомендуется использовать decipher.final() вместо этого.

DEP0106: crypto.createCipher и crypto.createDecipher

Тип: Выполнение

Использование crypto.createCipher() и crypto.createDecipher() следует избегать, так как они используют слабую функцию вывода ключа (MD5 без соли) и статические векторы инициализации. Рекомендуется выводить ключ с помощью crypto.pbkdf2() или crypto.scrypt() и использовать crypto.createCipheriv() и crypto.createDecipheriv() для получения объектов Cipher и Decipher соответственно.

DEP0107: tls.convertNPNProtocols()

Тип: Конец жизненного цикла

Это была незадокументированная вспомогательная функция, не предназначенная для использования за пределами ядра Node.js, и устарела из-за удаления поддержки NPN (Next Protocol Negotiation).

DEP0108: zlib.bytesRead

Тип: Во время выполнения

Устаревший псевдоним для zlib.bytesWritten. Это исходное имя было выбрано, потому что оно также имело смысл для интерпретации значения как числа байтов, прочитанных движком, но не соответствует другим потокам в Node.js, которые раскрывают значения под этими именами.

DEP0109: http, https, и tls поддержка недопустимых URL-адресов

Тип: Конец жизненного цикла

Некоторые ранее поддерживаемые (но строго недопустимые) URL-адреса принимались через http.request(), http.get(), https.request(), https.get() и tls.checkServerIdentity() API, поскольку они принимались устаревшим API url.parse(). Указанные API теперь используют анализатор URL WHATWG, который требует строго допустимых URL-адресов. Передача недопустимого URL-адреса устарела, и поддержка будет удалена в будущем.

DEP0110: vm.Script кэшированные данные

Тип: Только в документации

Параметр produceCachedData устарел. Используйте script.createCachedData() вместо этого.

DEP0111: process.binding()

Тип: Только в документации (поддерживает --pending-deprecation)

process.binding() предназначен только для использования внутренним кодом Node.js.

DEP0112: dgram частные API

Тип: Во время выполнения

Модуль dgram ранее содержал несколько API, которые никогда не должны были вызываться за пределами ядра Node.js: Socket.prototype._handle, Socket.prototype._receiving, Socket.prototype._bindState, Socket.prototype._queue, Socket.prototype._reuseAddr, Socket.prototype._healthCheck(), Socket.prototype._stopReceiving(), и dgram._createSocketHandle().

DEP0113: Cipher.setAuthTag(), Decipher.getAuthTag()

Тип: Конец жизненного цикла

Cipher.setAuthTag() и Decipher.getAuthTag() больше недоступны. Они никогда не документировались и вызывали бы исключение при вызове.

DEP0114: crypto._toBuf()

Тип: Конец жизненного цикла

Функция crypto._toBuf() не была предназначена для использования модулями за пределами ядра Node.js и была удалена.

DEP0115: crypto.prng(), crypto.pseudoRandomBytes(), crypto.rng()

Тип: Только в документации (поддерживает --pending-deprecation)

В недавних версиях Node.js нет разницы между crypto.randomBytes() и crypto.pseudoRandomBytes(). Последний устарел вместе с недокументированными псевдонимами crypto.prng() и crypto.rng() в пользу crypto.randomBytes() и может быть удален в будущих выпусках.

DEP0116: Устаревший API URL

Тип: Отмена устаревания

Устарел Устаревший API URL. Это включает url.format(), url.parse(), url.resolve() и устаревший urlObject. Используйте вместо этого WHATWG URL API.

DEP0117: Внутренние дескрипторы криптографических объектов

Тип: Конец жизненного цикла

Предыдущие версии Node.js предоставляли дескрипторы внутренних нативных объектов через свойство _handle классов Cipher, Decipher, DiffieHellman, DiffieHellmanGroup, ECDH, Hash, Hmac, Sign, и Verify. Свойство _handle было удалено, так как неправильное использование нативных объектов может привести к аварийному завершению приложения.

DEP0118: dns.lookup() поддержка пустого имени хоста

Тип: Во время выполнения

Предыдущие версии Node.js поддерживали dns.lookup() с ложным именем хоста, например dns.lookup(false), из-за обратной совместимости. Это поведение не документировано и, как полагают, не используется в реальных приложениях. В будущих версиях Node.js оно станет ошибкой.

DEP0119: process.binding('uv').errname() частный API

Тип: Только в документации (поддерживает --pending-deprecation)

process.binding('uv').errname() устарел. Используйте вместо этого util.getSystemErrorName().

DEP0120: Поддержка счетчиков производительности Windows

Тип: Конец жизненного цикла

Поддержка счетчиков производительности Windows была удалена из Node.js. Недокументированные функции COUNTER_NET_SERVER_CONNECTION(), COUNTER_NET_SERVER_CONNECTION_CLOSE(), COUNTER_HTTP_SERVER_REQUEST(), COUNTER_HTTP_SERVER_RESPONSE(), COUNTER_HTTP_CLIENT_REQUEST(), и COUNTER_HTTP_CLIENT_RESPONSE() устарели.

DEP0121: net._setSimultaneousAccepts()

Тип: Во время выполнения

Недокументированная функция net._setSimultaneousAccepts() изначально предназначалась для отладки и настройки производительности при использовании модулей child_process и cluster на Windows. Функция не является общеполезной и удаляется. См. обсуждение здесь: https://github.com/nodejs/node/issues/18391

DEP0122: tls Server.prototype.setOptions()

Тип: Во время выполнения

Используйте Server.prototype.setSecureContext() вместо этого.

DEP0123: установка имени сервера TLS на IP-адрес

Тип: Во время выполнения

Установка имени сервера TLS на IP-адрес не допускается RFC 6066. В будущей версии это будет проигнорировано.

DEP0124: использование REPLServer.rli

Тип: Конец жизненного цикла

Это свойство ссылается на сам экземпляр.

DEP0125: require('_stream_wrap')

Тип: Runtime

Модуль _stream_wrap устарел.

DEP0126: timers.active()

Тип: Runtime

Ранее недокументированный timers.active() устарел. Используйте вместо него публично документированный timeout.refresh(). Если переопределение таймаута необходимо, timeout.ref() можно использовать без потери производительности начиная с Node.js 10.

DEP0127: timers._unrefActive()

Тип: Runtime

Ранее недокументированный и "приватный" timers._unrefActive() устарел. Используйте вместо него публично документированный timeout.refresh(). Если нужно снять ссылку с таймаута, используйте timeout.unref() — без потери производительности начиная с Node.js 10.

DEP0128: модули с невалидным main и index.js файлом

Тип: Runtime

Модули с невалидным main (например, ./does-not-exist.js) и файлом index.js в корневом каталоге будут разрешать файл index.js. Это устарело и в будущих версиях Node.js вызовет ошибку.

DEP0129: ChildProcess._channel

Тип: Runtime

Свойство _channel объектов дочерних процессов, возвращаемых spawn() и аналогичными функциями, не предназначено для публичного использования. Используйте ChildProcess.channel вместо него.

DEP0130: Module.createRequireFromPath()

Тип: Достиг конец жизненного цикла

Используйте module.createRequire() вместо этого.

DEP0131: Устаревший парсер HTTP

Тип: Достиг конец жизненного цикла

Устаревший парсер HTTP, используемый по умолчанию в версиях Node.js до 12.0.0, устарел и был удален в v13.0.0. До v13.0.0, флагом командной строки --http-parser=legacy можно было вернуться к использованию устаревшего парсера.

DEP0132: worker.terminate() с обратным вызовом

Тип: Runtime

Передача обратного вызова в worker.terminate() устарела. Используйте возвращаемый Promise вместо этого, или обработчик события 'exit' рабочего процесса.

DEP0133: http connection

Тип: Только документация

Предпочтите response.socket вместо response.connection и request.socket вместо request.connection.

DEP0134: process._tickCallback

Тип: Только документация (поддерживает --pending-deprecation)

Свойство process._tickCallback никогда не было официально документировано как поддерживаемый API.

DEP0135: WriteStream.open() и ReadStream.open() являются внутренними

Тип: Runtime

WriteStream.open() и ReadStream.open() — недокументированные внутренние API, не предназначенные для использования в пользовательском коде. Потоки файлов всегда должны открываться через соответствующие фабричные методы fs.createWriteStream() и fs.createReadStream(), или путём передачи дескриптора файла в опциях.

DEP0136: http finished

Тип: Только документация

response.finished указывает, был ли вызван response.end(), а не то, было ли эмитировано событие 'finish' и данные сброшены.

Используйте соответственно response.writableFinished или response.writableEnded, чтобы избежать неоднозначности.

Для сохранения предыдущего поведения response.finished необходимо заменить на response.writableEnded.

DEP0137: Закрытие fs.FileHandle при сборке мусора

Тип: Runtime

Устарело разрешение объекта fs.FileHandle на закрытие при сборке мусора. В будущем это может привести к ошибке, завершающей процесс.

Убедитесь, что все объекты fs.FileHandle явным образом закрываются с помощью FileHandle.prototype.close(), когда fs.FileHandle больше не требуется:

const fsPromises = require('fs').promises;
async function openAndClose() {
  let filehandle;
  try {
    filehandle = await fsPromises.open('thefile.txt', 'r');
  } finally {
    if (filehandle !== undefined)
      await filehandle.close();
  }
}

DEP0138: process.mainModule

Тип: Только документация

process.mainModule — функция только для CommonJS, в то время как глобальный объект process доступен в средах, не использующих CommonJS. Его использование в модулях ECMAScript не поддерживается.

Она устарела в пользу require.main, так как служит той же цели, но доступна только в средах CommonJS.

DEP0139: process.umask() без аргументов

Тип: Только документация

Вызов process.umask() без аргументов приводит к дважды записанному маске процесса. Это создаёт состояние гонки между потоками и потенциальную уязвимость для безопасности. Безопасного кроссплатформенного альтернативного API нет.

DEP0140: Используйте request.destroy() вместо request.abort()

Тип: Только документация

Используйте request.destroy() вместо request.abort().

DEP0141: repl.inputStream и repl.outputStream

Тип: Только документация (поддерживает --pending-deprecation)

Модуль repl экспортировал входной и выходной потоки дважды. Используйте .input вместо .inputStream и .output вместо .outputStream.

DEP0142: repl._builtinLibs

Тип: Только документация

Модуль repl экспортирует свойство _builtinLibs, содержащее массив нативных модулей. Оно до сих пор неполное, и лучше полагаться на require('module').builtinModules.

DEP0143: Transform._transformState

Тип: Режим выполнения Transform._transformState будет удален в будущих версиях, так как он больше не требуется из-за упрощения реализации.

DEP0144: module.parent

Тип: Только документация (поддерживает --pending-deprecation)

Модуль CommonJS может получить доступ к первому модулю, который его потребовал, используя module.parent. Эта функция устарела, так как она не работает последовательно в присутствии модулей ECMAScript и потому что предоставляет неточное представление графа модулей CommonJS.

Некоторые модули используют его для проверки, являются ли они точкой входа текущего процесса. Вместо этого рекомендуется сравнить require.main и module:

if (require.main === module) {
  // Code section that will run only if current file is the entry point.
}

При поиске модулей CommonJS, потребовавших текущий, можно использовать require.cache и module.children:

const moduleParents = Object.values(require.cache)
  .filter((m) => m.children.includes(module));

DEP0145: socket.bufferSize

Тип: Только документация

socket.bufferSize — всего лишь псевдоним для writable.writableLength.

DEP0146: new crypto.Certificate()

Тип: Только документация

Конструктор crypto.Certificate() устарел. Используйте вместо него статические методы crypto.Certificate().

DEP0147: fs.rmdir(path, { recursive: true })

Тип: Режим выполнения

В будущих версиях Node.js параметр recursive будет игнорироваться для fs.rmdir, fs.rmdirSync, и fs.promises.rmdir.

Используйте fs.rm(path, { recursive: true, force: true }), fs.rmSync(path, { recursive: true, force: true }) или fs.promises.rm(path, { recursive: true, force: true }) вместо этого.

DEP0148: Сопоставления папок в "exports" (завершающий "/")

Тип: Режим выполнения

Использование завершающего "/" для определения сопоставлений папок подпутей в полях экспорта подпутей или импортов подпутей устарело. Используйте вместо этого шаблоны подпутей.

DEP0149: http.IncomingMessage#connection

Тип: Только документация.

Предпочитайте message.socket вместо message.connection.

DEP0150: Изменение значения process.config

Тип: Режим выполнения

Свойство process.config предназначено для предоставления доступа к параметрам конфигурации, установленным при компиляции двоичного файла Node.js. Однако свойство было изменяемым кодом пользователя, что делало его невозможным для использования. Возможность изменения значения устарела и будет отключена в будущем.

DEP0151: Поиск главного индекса и расширений

Тип: Режим выполнения

Ранее поиск index.js и расширений применялся к разрешению основной точки входа import 'pkg', даже при разрешении ES-модулей.

С этой отменой все разрешения ES-модулей основной точки входа требуют явного "exports" или "main" входа с точным расширением файла.

DEP0152: Свойства расширений PerformanceEntry

Тип: Режим выполнения

Типам объектов 'gc', 'http2', и 'http' <PerformanceEntry> присваиваются дополнительные свойства, предоставляющие дополнительную информацию. Теперь эти свойства доступны в стандартном свойстве detail объекта PerformanceEntry. Прежние методы доступа устарели и больше не должны использоваться.

DEP0153: dns.lookup и dnsPromises.lookup опции преобразования типа

Тип: Только документация

Использование непустого нецелого значения для параметра family, нечислового значения для параметра hints, небулевого значения для параметра all или небулевого значения для параметра verbatim в dns.lookup() и dnsPromises.lookup() устарело.

DEP0154: Параметры генерации пары ключей RSA-PSS

Тип: Только документация (поддерживает --pending-deprecation)

Параметры 'hash' и 'mgf1Hash' заменены на 'hashAlgorithm' и 'mgf1HashAlgorithm'.

DEP0155: Косые черты в конце в разрешениях спецификаторов шаблонов

Тип: Только документация (поддерживает --pending-deprecation)

Переназначение спецификаторов, заканчивающихся на "/" (например, import 'pkg/x/') устарело для разрешений пакетов "exports" и "imports" шаблонов.

DEP0156: Свойство .aborted и события 'abort', 'aborted' в http

Тип: Только документация

Перейдите к API <Поток> вместо него, так как http.ClientRequest, http.ServerResponse и http.IncomingMessage все основаны на потоках. Проверяйте stream.destroyed вместо свойства .aborted, и подписывайтесь на событие 'close' вместо 'abort', 'aborted'.

Свойство .aborted и событие 'abort' полезны только для обнаружения вызовов .abort(). Для раннего завершения запроса используйте поток .destroy([error]), а затем проверьте свойство .destroyed и событие 'close', которые должны иметь тот же эффект. Принимающая сторона также должна проверить значение readable.readableEnded в объекте http.IncomingMessage, чтобы узнать, был ли это прерванный или плавный уничтожение.