NodeJSReadableStream interface
Node.js доступный destroy для чтения поток, который также имеет метод.
- Расширяет
-
ReadableStream
Унаследованные свойства
| readable |
Методика
| destroy(Error) | Уничтожить поток. При необходимости выдает событие error и выдает событие close (если для emitClose не задано значение false). После этого вызова внутренние ресурсы будут освобождены. |
Наследуемые методы
| add |
Псевдоним для |
| emit<E>(string | symbol, any[]) | Синхронно вызывает каждый из прослушивателей, зарегистрированных для события с именем Возвращает
|
| event |
Возвращает массив, в котором перечислены события, для которых у поставщика зарегистрированы прослушиватели.
|
| get |
Возвращает текущее значение максимального прослушивателя для |
| is |
|
| listener |
Возвращает число прослушивателей, прослушивающих событие с именем |
| listeners<E>(string | symbol) | Возвращает копию массива прослушивателей для события с именем
|
| off<E>(string | symbol, (args: any[]) => void) | Псевдоним для |
| on<E>(string | symbol, (args: any[]) => void) | Добавляет функцию
Возвращает ссылку на По умолчанию прослушиватели событий вызываются в том порядке, в который они добавляются. Метод
|
| once<E>(string | symbol, (args: any[]) => void) | Добавляет функцию однократного
Возвращает ссылку на По умолчанию прослушиватели событий вызываются в том порядке, в который они добавляются. Метод
|
| pause() | |
| pipe<T>(T, { end?: boolean }) | |
| prepend |
Добавляет функцию
Возвращает ссылку на |
| prepend |
Добавляет функцию однократного
Возвращает ссылку на |
| raw |
Возвращает копию массива прослушивателей для события с именем
|
| read(number) | |
| remove |
Удаляет все прослушиватели или те из указанных Не рекомендуется удалять прослушиватели, добавленные в другое место в коде, особенно если экземпляр Возвращает ссылку на |
| remove |
Удаляет указанный
После создания события все прослушиватели, подключенные к нему во время создания, вызываются в порядке. Это означает, что любые
Поскольку слушатели управляются с помощью внутреннего массива, вызов этого параметра изменяет индексы позиций любого слушателя, зарегистрированного после удаления слушателя. Это не повлияет на порядок вызова прослушивателей, но это означает, что все копии массива прослушивателя, возвращенные методом Если одна функция была добавлена в обработчик несколько раз для одного события (как в примере ниже),
Возвращает ссылку на |
| resume() | |
| set |
|
| set |
По умолчанию Возвращает ссылку на |
| unpipe(Writable |
|
| unshift(string | Uint8Array, Buffer |
|
| wrap(Readable |
|
| [async |
|
| [capture |
Метод
|
Сведения о унаследованном имуществе
readable
readable: boolean
Стоимость недвижимости
boolean
Наследуется от NodeJS.ReadableStream.readable
Подробнее о методе
destroy(Error)
Уничтожить поток. При необходимости выдает событие error и выдает событие close (если для emitClose не задано значение false). После этого вызова внутренние ресурсы будут освобождены.
function destroy(error?: Error)
Параметры
- error
-
Error
Сведения о наследуемом методе
addListener<E>(string | symbol, (args: any[]) => void)
Псевдоним для emitter.on(eventName, listener).
function addListener<E>(eventName: string | symbol, listener: (args: any[]) => void): NodeJSReadableStream
Параметры
- eventName
-
string | symbol
- listener
-
(args: any[]) => void
Возвращает
Наследуется от NodeJS.ReadableStream.addListener
emit<E>(string | symbol, any[])
Синхронно вызывает каждый из прослушивателей, зарегистрированных для события с именем eventName, в том порядке, в который они были зарегистрированы, передавая предоставленные аргументы каждому из них.
Возвращает true, если событие имело прослушиватели, false в противном случае.
import { EventEmitter } from 'node:events';
const myEmitter = new EventEmitter();
// First listener
myEmitter.on('event', function firstListener() {
console.log('Helloooo! first listener');
});
// Second listener
myEmitter.on('event', function secondListener(arg1, arg2) {
console.log(`event with parameters ${arg1}, ${arg2} in second listener`);
});
// Third listener
myEmitter.on('event', function thirdListener(...args) {
const parameters = args.join(', ');
console.log(`event with parameters ${parameters} in third listener`);
});
console.log(myEmitter.listeners('event'));
myEmitter.emit('event', 1, 2, 3, 4, 5);
// Prints:
// [
// [Function: firstListener],
// [Function: secondListener],
// [Function: thirdListener]
// ]
// Helloooo! first listener
// event with parameters 1, 2 in second listener
// event with parameters 1, 2, 3, 4, 5 in third listener
function emit<E>(eventName: string | symbol, args: any[]): boolean
Параметры
- eventName
-
string | symbol
- args
-
any[]
Возвращает
boolean
Наследуется от NodeJS.ReadableStream.emit
eventNames()
Возвращает массив, в котором перечислены события, для которых у поставщика зарегистрированы прослушиватели.
import { EventEmitter } from 'node:events';
const myEE = new EventEmitter();
myEE.on('foo', () => {});
myEE.on('bar', () => {});
const sym = Symbol('symbol');
myEE.on(sym, () => {});
console.log(myEE.eventNames());
// Prints: [ 'foo', 'bar', Symbol(symbol) ]
function eventNames(): (string | symbol)[]
Возвращает
(string | symbol)[]
Наследуется от NodeJS.ReadableStream.eventNames
getMaxListeners()
Возвращает текущее значение максимального прослушивателя для EventEmitter, заданное emitter.setMaxListeners(n) или значением по умолчанию events.defaultMaxListeners.
function getMaxListeners(): number
Возвращает
number
Наследуется от NodeJS.ReadableStream.getMaxListeners
isPaused()
function isPaused(): boolean
Возвращает
boolean
Наследуется от NodeJS.ReadableStream.isPaused
listenerCount<E>(string | symbol, (args: any[]) => void)
Возвращает число прослушивателей, прослушивающих событие с именем eventName.
Если указана listener, он возвращает количество раз, когда прослушиватель найден в списке прослушивателей события.
function listenerCount<E>(eventName: string | symbol, listener?: (args: any[]) => void): number
Параметры
- eventName
-
string | symbol
Имя прослушиваемого события
- listener
-
(args: any[]) => void
Функция обработчика событий
Возвращает
number
Наследуется от NodeJS.ReadableStream.listenerCount
listeners<E>(string | symbol)
Возвращает копию массива прослушивателей для события с именем eventName.
server.on('connection', (stream) => {
console.log('someone connected!');
});
console.log(util.inspect(server.listeners('connection')));
// Prints: [ [Function] ]
function listeners<E>(eventName: string | symbol): (args: any[]) => void[]
Параметры
- eventName
-
string | symbol
Возвращает
(args: any[]) => void[]
Наследуется от NodeJS.ReadableStream.прослушиватели
off<E>(string | symbol, (args: any[]) => void)
Псевдоним для emitter.removeListener().
function off<E>(eventName: string | symbol, listener: (args: any[]) => void): NodeJSReadableStream
Параметры
- eventName
-
string | symbol
- listener
-
(args: any[]) => void
Возвращает
Наследуется от NodeJS.ReadableStream.off
on<E>(string | symbol, (args: any[]) => void)
Добавляет функцию listener в конец массива прослушивателей для события с именем eventName. Проверка не выполняется, чтобы узнать, добавлена ли listener. Несколько вызовов, проходящих одно и то же сочетание eventName и listener, приведет к добавлению listener и вызову несколько раз.
server.on('connection', (stream) => {
console.log('someone connected!');
});
Возвращает ссылку на EventEmitter, чтобы вызовы могли быть связаны.
По умолчанию прослушиватели событий вызываются в том порядке, в который они добавляются. Метод emitter.prependListener() можно использовать в качестве альтернативы для добавления прослушивателя событий в начало массива прослушивателей.
import { EventEmitter } from 'node:events';
const myEE = new EventEmitter();
myEE.on('foo', () => console.log('a'));
myEE.prependListener('foo', () => console.log('b'));
myEE.emit('foo');
// Prints:
// b
// a
function on<E>(eventName: string | symbol, listener: (args: any[]) => void): NodeJSReadableStream
Параметры
- eventName
-
string | symbol
Имя события.
- listener
-
(args: any[]) => void
Функция обратного вызова
Возвращает
Наследуется от NodeJS.ReadableStream.on
once<E>(string | symbol, (args: any[]) => void)
Добавляет функцию однократногоeventName этот прослушиватель удаляется и вызывается.
server.once('connection', (stream) => {
console.log('Ah, we have our first user!');
});
Возвращает ссылку на EventEmitter, чтобы вызовы могли быть связаны.
По умолчанию прослушиватели событий вызываются в том порядке, в который они добавляются. Метод emitter.prependOnceListener() можно использовать в качестве альтернативы для добавления прослушивателя событий в начало массива прослушивателей.
import { EventEmitter } from 'node:events';
const myEE = new EventEmitter();
myEE.once('foo', () => console.log('a'));
myEE.prependOnceListener('foo', () => console.log('b'));
myEE.emit('foo');
// Prints:
// b
// a
function once<E>(eventName: string | symbol, listener: (args: any[]) => void): NodeJSReadableStream
Параметры
- eventName
-
string | symbol
Имя события.
- listener
-
(args: any[]) => void
Функция обратного вызова
Возвращает
Наследуется от NodeJS.ReadableStream.once
pause()
function pause(): NodeJSReadableStream
Возвращает
Наследуется от NodeJS.ReadableStream.pause
pipe<T>(T, { end?: boolean })
function pipe<T>(destination: T, options?: { end?: boolean }): T
Параметры
- destination
-
T
- options
-
{ end?: boolean }
Возвращает
T
Наследуется от NodeJS.ReadableStream.pipe
prependListener<E>(string | symbol, (args: any[]) => void)
Добавляет функцию listener в начала массива прослушивателей для события с именем eventName. Проверка не выполняется, чтобы узнать, добавлена ли listener. Несколько вызовов, проходящих одно и то же сочетание eventName и listener, приведет к добавлению listener и вызову несколько раз.
server.prependListener('connection', (stream) => {
console.log('someone connected!');
});
Возвращает ссылку на EventEmitter, чтобы вызовы могли быть связаны.
function prependListener<E>(eventName: string | symbol, listener: (args: any[]) => void): NodeJSReadableStream
Параметры
- eventName
-
string | symbol
Имя события.
- listener
-
(args: any[]) => void
Функция обратного вызова
Возвращает
Наследуется от NodeJS.ReadableStream.prependListener
prependOnceListener<E>(string | symbol, (args: any[]) => void)
Добавляет функцию однократногоeventName этот прослушиватель удаляется, а затем вызывается.
server.prependOnceListener('connection', (stream) => {
console.log('Ah, we have our first user!');
});
Возвращает ссылку на EventEmitter, чтобы вызовы могли быть связаны.
function prependOnceListener<E>(eventName: string | symbol, listener: (args: any[]) => void): NodeJSReadableStream
Параметры
- eventName
-
string | symbol
Имя события.
- listener
-
(args: any[]) => void
Функция обратного вызова
Возвращает
Наследуется от NodeJS.ReadableStream.prependOnceListener
rawListeners<E>(string | symbol)
Возвращает копию массива прослушивателей для события с именем eventName, включая любые оболочки (например, созданные .once()).
import { EventEmitter } from 'node:events';
const emitter = new EventEmitter();
emitter.once('log', () => console.log('log once'));
// Returns a new Array with a function `onceWrapper` which has a property
// `listener` which contains the original listener bound above
const listeners = emitter.rawListeners('log');
const logFnWrapper = listeners[0];
// Logs "log once" to the console and does not unbind the `once` event
logFnWrapper.listener();
// Logs "log once" to the console and removes the listener
logFnWrapper();
emitter.on('log', () => console.log('log persistently'));
// Will return a new Array with a single function bound by `.on()` above
const newListeners = emitter.rawListeners('log');
// Logs "log persistently" twice
newListeners[0]();
emitter.emit('log');
function rawListeners<E>(eventName: string | symbol): (args: any[]) => void[]
Параметры
- eventName
-
string | symbol
Возвращает
(args: any[]) => void[]
Наследуется от NodeJS.ReadableStream.rawListeners
read(number)
function read(size?: number): string | Buffer
Параметры
- size
-
number
Возвращает
string | Buffer
Наследуется от NodeJS.ReadableStream.read
removeAllListeners<E>(string | symbol)
Удаляет все прослушиватели или те из указанных eventName.
Не рекомендуется удалять прослушиватели, добавленные в другое место в коде, особенно если экземпляр EventEmitter был создан другим компонентом или модулем (например, сокетами или потоками файлов).
Возвращает ссылку на EventEmitter, чтобы вызовы могли быть связаны.
function removeAllListeners<E>(eventName?: string | symbol): NodeJSReadableStream
Параметры
- eventName
-
string | symbol
Возвращает
Наследуется от NodeJS.ReadableStream.removeAllListeners
removeListener<E>(string | symbol, (args: any[]) => void)
Удаляет указанный listener из массива прослушивателя для события с именем eventName.
const callback = (stream) => {
console.log('someone connected!');
};
server.on('connection', callback);
// ...
server.removeListener('connection', callback);
removeListener() удаляет в большинстве случаев один экземпляр прослушивателя из массива прослушивателя. Если один прослушиватель был добавлен несколько раз в массив прослушивателя для указанного eventName, removeListener() необходимо вызывать несколько раз, чтобы удалить каждый экземпляр.
После создания события все прослушиватели, подключенные к нему во время создания, вызываются в порядке. Это означает, что любые removeListener() вызовы removeAllListeners()OR после эмитирования и до завершения выполнения последним слушателем не удалят их из emit() процесса. Последующие события ведут себя должным образом.
import { EventEmitter } from 'node:events';
class MyEmitter extends EventEmitter {}
const myEmitter = new MyEmitter();
const callbackA = () => {
console.log('A');
myEmitter.removeListener('event', callbackB);
};
const callbackB = () => {
console.log('B');
};
myEmitter.on('event', callbackA);
myEmitter.on('event', callbackB);
// callbackA removes listener callbackB but it will still be called.
// Internal listener array at time of emit [callbackA, callbackB]
myEmitter.emit('event');
// Prints:
// A
// B
// callbackB is now removed.
// Internal listener array [callbackA]
myEmitter.emit('event');
// Prints:
// A
Поскольку слушатели управляются с помощью внутреннего массива, вызов этого параметра изменяет индексы позиций любого слушателя, зарегистрированного после удаления слушателя. Это не повлияет на порядок вызова прослушивателей, но это означает, что все копии массива прослушивателя, возвращенные методом emitter.listeners(), должны быть воссозданы.
Если одна функция была добавлена в обработчик несколько раз для одного события (как в примере ниже), removeListener() удалит последний добавленный экземпляр. В примере прослушивателя once('ping') удаляется:
import { EventEmitter } from 'node:events';
const ee = new EventEmitter();
function pong() {
console.log('pong');
}
ee.on('ping', pong);
ee.once('ping', pong);
ee.removeListener('ping', pong);
ee.emit('ping');
ee.emit('ping');
Возвращает ссылку на EventEmitter, чтобы вызовы могли быть связаны.
function removeListener<E>(eventName: string | symbol, listener: (args: any[]) => void): NodeJSReadableStream
Параметры
- eventName
-
string | symbol
- listener
-
(args: any[]) => void
Возвращает
Наследуется от NodeJS.ReadableStream.removeListener
resume()
function resume(): NodeJSReadableStream
Возвращает
Наследуется от NodeJS.ReadableStream.resume
setEncoding(BufferEncoding)
function setEncoding(encoding: BufferEncoding): NodeJSReadableStream
Параметры
- encoding
-
BufferEncoding
Возвращает
Наследуется от NodeJS.ReadableStream.setEncoding
setMaxListeners(number)
По умолчанию EventEmitterбудет выводить предупреждение, если для определенного события добавляются более 10 прослушивателей. Это полезное значение по умолчанию, которое помогает находить утечки памяти. Метод emitter.setMaxListeners() позволяет изменить ограничение для этого конкретного экземпляра EventEmitter. Для указания неограниченного количества прослушивателей можно задать значение Infinity (или 0).
Возвращает ссылку на EventEmitter, чтобы вызовы могли быть связаны.
function setMaxListeners(n: number): NodeJSReadableStream
Параметры
- n
-
number
Возвращает
Наследуется от NodeJS.ReadableStream.setMaxListeners
unpipe(WritableStream)
function unpipe(destination?: WritableStream): NodeJSReadableStream
Параметры
- destination
-
WritableStream
Возвращает
Наследуется от NodeJS.ReadableStream.unpipe
unshift(string | Uint8Array, BufferEncoding)
function unshift(chunk: string | Uint8Array, encoding?: BufferEncoding)
Параметры
- chunk
-
string | Uint8Array
- encoding
-
BufferEncoding
Наследуется от NodeJS.ReadableStream.unshift
wrap(ReadableStream)
function wrap(oldStream: ReadableStream): NodeJSReadableStream
Параметры
- oldStream
-
ReadableStream
Возвращает
Наследуется от NodeJS.ReadableStream.wrap
[asyncIterator]()
function [asyncIterator](): AsyncIterableIterator<string | Buffer>
Возвращает
AsyncIterableIterator<string | Buffer>
Унаследовано от NodeJS.ReadableStream.__@asyncIterator@163
[captureRejectionSymbol](Error, string | symbol, any[])
Метод Symbol.for('nodejs.rejection') вызывается в случае, если при выпуске события происходит отказ обещания и captureRejections активируется на эмиттере.
Возможно использовать events.captureRejectionSymbol вместо Symbol.for('nodejs.rejection').
import { EventEmitter, captureRejectionSymbol } from 'node:events';
class MyClass extends EventEmitter {
constructor() {
super({ captureRejections: true });
}
[captureRejectionSymbol](err, event, ...args) {
console.log('rejection happened for', event, 'with', err, ...args);
this.destroy(err);
}
destroy(err) {
// Tear the resource down here.
}
}
function [captureRejectionSymbol](error: Error, event: string | symbol, args: any[])
Параметры
- error
-
Error
- event
-
string | symbol
- args
-
any[]
Унаследовано от NodeJS.ReadableStream.__@captureRejectionSymbol@180