Client class
IoT Hub hizmeti istemcisi, bir Azure IoT hub'ı aracılığıyla cihazlarla iletişim kurmak için kullanılır. SDK kullanıcısının şunları yapmasını sağlar:
- cihazlara buluttan cihaza (komut olarak da bilinir) gönderme: komutlar IoT Hub kuyruğa alınır ve yalnızca cihaz bağlandığında zaman uyumsuz olarak teslim edilir. Cihaz başına yalnızca 50 komut kuyruğa alınabiliyor.
- cihazlarda doğrudan yöntemleri çağırma (yalnızca cihaz şu anda bağlıysa çalışır: cihazla zaman uyumlu bir iletişim yöntemidir)
- önceki komutlar için cihazlar tarafından gönderilen geri bildirim iletilerini dinleyin.
- cihazlardan dosya yükleme bildirimlerini dinleyin.
Kullanıcılar bir IoT Hub hizmeti İstemcisi oluşturmak içinConnectionString veya fromSharedAccessSignature'dan fabrika yöntemlerinden birini çağırarak yeni Client örnekler oluşturmalıdır.
- Extends
-
EventEmitter
Devralınan Özellikler
capture |
Değer: boole değeri Tüm yeni |
capture |
Değer: Özel |
default |
Varsayılan olarak, herhangi bir olay için en fazla ayarını Bu sabit bir sınır değildir. Örnek
Komut Gösterilen uyarı ile |
error |
Bu simge yalnızca izleme Bu simgeyi kullanarak bir dinleyicinin yüklenmesi, bir |
Yöntemler
close() | |
close(Incoming |
IoT hub'ına bağlantıyı kapatır. |
from |
Varsayılan taşımayı (Amqp) veya ikinci bağımsız değişkende belirtileni kullanarak verilen bağlantı dizesi bir IoT Hub hizmet istemcisi oluşturur. |
from |
Varsayılan aktarım (Amqp) veya ikinci bağımsız değişkende belirtileni kullanarak verilen paylaşılan erişim imzasından bir IoT Hub hizmet istemcisi oluşturur. |
from |
Varsayılan taşımayı (Amqp) veya ikinci bağımsız değişkende belirtileni kullanarak verilen Azure tokenCredential'dan bir IoT Hub hizmet istemcisi oluşturur. |
get |
|
get |
İstemci tarafından yeni geri bildirim iletileri alındığında olayları yayan bir AmqpReceiver nesnesi döndürür. |
get |
|
get |
İstemci tarafından yeni dosya karşıya yükleme bildirimleri alındığında olayları yayan bir AmqpReceiver nesnesi döndürür. |
invoke |
|
invoke |
Belirli bir cihaz veya modülde bir yöntemi çağırır. |
invoke |
|
invoke |
|
open() | |
open(Incoming |
IoT hub'ına bağlantıyı açar. |
send(string, Message | Buffer |
|
send(string, Message | Buffer |
Bir cihaza ileti gönderir. |
set |
İstemci tarafından ağ işlemlerini yeniden denemek için kullanılan ilkeyi ayarlayın. |
Devralınan Yöntemler
add |
Sağlanan Durdurma sinyallerinde olayı dinlemek Bu API, dinleyicinin çalışmasını engellemeyen olayı Aboneliğinin daha kolay kaldırılabilmesi için atılabilir bir değer döndürür.
|
add |
için |
emit<K>(string | symbol, Any |
Adlı olay Olayın dinleyicileri varsa,
|
event |
Vericinin dinleyicileri kaydettiği olayları listeleyen bir dizi döndürür. Dizideki değerler dize veya
|
get |
adlı s için için
|
get |
defaultMaxListeners tarafından |
get |
Şu anda ayarlanmış en fazla dinleyici miktarını döndürür. s için için
|
listener |
Verilen
|
listener |
adlı |
listeners<K>(string | symbol) | adlı
|
off<K>(string | symbol, (args: any[]) => void) | için |
on(Event |
Olayları yineleyen ,
|
on<K>(string | symbol, (args: any[]) => void) |
Çağrıların Varsayılan olarak, olay dinleyicileri eklendikleri sırayla çağrılır. yöntemi,
|
once(Event |
Belirtilen olayı yaydığında Bu yöntem kasıtlı olarak geneldir ve özel
Olayın özel işlemesi
,
|
once(_DOMEvent |
|
once<K>(string | symbol, (args: any[]) => void) | adlı
Çağrıların Varsayılan olarak, olay dinleyicileri eklendikleri sırayla çağrılır. yöntemi,
|
prepend |
Çağrıların |
prepend |
adlı olay
Çağrıların |
raw |
adlı
|
remove |
Tüm dinleyicileri veya belirtilen Özellikle örnek başka bir bileşen veya modül (örneğin yuvalar veya dosya akışları) tarafından oluşturulduğunda kodun Çağrıların |
remove |
adlı
Bir olay yayımlandıktan sonra, yayma sırasında ona eklenen tüm dinleyiciler sırayla çağrılır. Bu, yadıktan sonra ve son dinleyici yürütmeyi bitirmeden önce yapılan veya
Dinleyiciler bir iç dizi kullanılarak yönetildiğinden, bu çağrı, dinleyici kaldırıldıktan sonra kaydedilen herhangi bir dinleyicinin konum dizinlerini değiştirir. Bu, dinleyicilerin çağrılma sırasını etkilemez, ancak yöntemi tarafından Tek bir işlev tek bir olay için birden çok kez işleyici olarak eklendiğinde (aşağıdaki örnekte olduğu gibi),
Çağrıların |
set |
Varsayılan olarak Çağrıların |
set |
|
[capture |
Devralınan Özellik Detayları
captureRejections
Değer: boole değeri
Tüm yeni EventEmitter
nesnelerdeki varsayılan captureRejections
seçeneği değiştirin.
static captureRejections: boolean
Özellik Değeri
boolean
Devralınan EventEmitter.captureRejections
captureRejectionSymbol
Değer: Symbol.for('nodejs.rejection')
Özel rejection handler
yazma bölümüne bakın.
static captureRejectionSymbol: typeof captureRejectionSymbol
Özellik Değeri
typeof captureRejectionSymbol
Devralınan EventEmitter.captureRejectionSymbol
defaultMaxListeners
Varsayılan olarak, herhangi bir olay için en fazla 10
dinleyici kaydedilebilir. Bu sınır, yöntemi kullanılarak emitter.setMaxListeners(n)
tek tek EventEmitter
örnekler için değiştirilebilir. TümEventEmitter
örneklerin varsayılan değerini events.defaultMaxListeners
değiştirmek için özelliği kullanılabilir. Bu değer pozitif bir sayı değilse, bir RangeError
oluşturulur.
ayarını events.defaultMaxListeners
yaparken dikkatli olun çünkü değişiklik, değişiklik yapılmadan önce oluşturulanlar da dahil olmak üzere tümEventEmitter
örnekleri etkiler. Ancak, çağrısının emitter.setMaxListeners(n)
üzerinde önceliği events.defaultMaxListeners
vardır.
Bu sabit bir sınır değildir. Örnek EventEmitter
daha fazla dinleyici eklenmesine izin verir ancak stderr'a "olası EventEmitter bellek sızıntısı" algılandığını belirten bir izleme uyarısı verir. Herhangi bir tekEventEmitter
emitter.getMaxListeners()
için ve emitter.setMaxListeners()
yöntemleri bu uyarıyı geçici olarak önlemek için kullanılabilir:
import { EventEmitter } from 'node:events';
const emitter = new EventEmitter();
emitter.setMaxListeners(emitter.getMaxListeners() + 1);
emitter.once('event', () => {
// do stuff
emitter.setMaxListeners(Math.max(emitter.getMaxListeners() - 1, 0));
});
Komut --trace-warnings
satırı bayrağı, bu tür uyarıların yığın izlemesini görüntülemek için kullanılabilir.
Gösterilen uyarı ile process.on('warning')
denetlenebilir ve ek , type
ve özelliklerine sahip emitter
olur; count
sırasıyla olay verici örneğine, olayın adına ve eklenen dinleyici sayısına başvurur.
Özelliği name
olarak 'MaxListenersExceededWarning'
ayarlanır.
static defaultMaxListeners: number
Özellik Değeri
number
Devralınan EventEmitter.defaultMaxListeners
errorMonitor
Bu simge yalnızca izleme 'error'
olayları için bir dinleyici yüklemek için kullanılır. Bu simge kullanılarak yüklenen dinleyiciler, normal'error'
dinleyiciler çağrılmadan önce çağrılır.
Bu simgeyi kullanarak bir dinleyicinin yüklenmesi, bir'error'
olay yayımlandıktan sonra davranışı değiştirmez. Bu nedenle, normal 'error'
dinleyici yüklü değilse işlem yine de kilitlenir.
static errorMonitor: typeof errorMonitor
Özellik Değeri
typeof errorMonitor
Devralınan EventEmitter.errorMonitor
Yöntem Ayrıntıları
close()
function close(): Promise<ResultWithIncomingMessage<Disconnected>>
Döndürülenler
Promise<ResultWithIncomingMessage<Disconnected>>
close(IncomingMessageCallback<Disconnected>)
IoT hub'ına bağlantıyı kapatır.
function close(done?: IncomingMessageCallback<Disconnected>)
Parametreler
- done
-
IncomingMessageCallback<Disconnected>
İşlem tamamlandığında çağrılacak isteğe bağlı işlev. done
bir Hata nesnesi bağımsız değişkeni geçirilir ve işlem başarıyla tamamlanırsa null olur.
fromConnectionString(string, TransportCtor)
Varsayılan taşımayı (Amqp) veya ikinci bağımsız değişkende belirtileni kullanarak verilen bağlantı dizesi bir IoT Hub hizmet istemcisi oluşturur.
static function fromConnectionString(connStr: string, transportCtor?: TransportCtor): Client
Parametreler
- connStr
-
string
IoT hub'ındaki "cihaz bağlantısı" izinlerini kapsülleyen bir bağlantı dizesi.
- transportCtor
- TransportCtor
Döndürülenler
fromSharedAccessSignature(string, TransportCtor)
Varsayılan aktarım (Amqp) veya ikinci bağımsız değişkende belirtileni kullanarak verilen paylaşılan erişim imzasından bir IoT Hub hizmet istemcisi oluşturur.
static function fromSharedAccessSignature(sharedAccessSignature: string, transportCtor?: TransportCtor): Client
Parametreler
- sharedAccessSignature
-
string
IoT hub'ındaki "hizmet bağlantısı" izinlerini kapsülleyen paylaşılan erişim imzası.
- transportCtor
- TransportCtor
Döndürülenler
fromTokenCredential(string, TokenCredential, TransportCtor)
Varsayılan taşımayı (Amqp) veya ikinci bağımsız değişkende belirtileni kullanarak verilen Azure tokenCredential'dan bir IoT Hub hizmet istemcisi oluşturur.
static function fromTokenCredential(hostName: string, tokenCredential: TokenCredential, transportCtor?: TransportCtor): Client
Parametreler
- hostName
-
string
Azure hizmetinin ana bilgisayar adı.
- tokenCredential
- TokenCredential
Azure hizmetiyle kimlik doğrulaması yapmak için kullanılan Bir Azure TokenCredential
- transportCtor
- TransportCtor
Döndürülenler
getFeedbackReceiver()
function getFeedbackReceiver(): Promise<ResultWithIncomingMessage<ServiceReceiver>>
Döndürülenler
Promise<ResultWithIncomingMessage<ServiceReceiver>>
getFeedbackReceiver(IncomingMessageCallback<ServiceReceiver>)
İstemci tarafından yeni geri bildirim iletileri alındığında olayları yayan bir AmqpReceiver nesnesi döndürür.
function getFeedbackReceiver(done?: IncomingMessageCallback<ServiceReceiver>)
Parametreler
- done
-
IncomingMessageCallback<ServiceReceiver>
İşlem tamamlandığında çağrılacak isteğe bağlı işlev. done
iki bağımsız değişkenle çağrılır: Error nesnesi (null olabilir) ve AmqpReceiver nesnesi.
getFileNotificationReceiver()
function getFileNotificationReceiver(): Promise<ResultWithIncomingMessage<ServiceReceiver>>
Döndürülenler
Promise<ResultWithIncomingMessage<ServiceReceiver>>
getFileNotificationReceiver(IncomingMessageCallback<ServiceReceiver>)
İstemci tarafından yeni dosya karşıya yükleme bildirimleri alındığında olayları yayan bir AmqpReceiver nesnesi döndürür.
function getFileNotificationReceiver(done?: IncomingMessageCallback<ServiceReceiver>)
Parametreler
- done
-
IncomingMessageCallback<ServiceReceiver>
İşlem tamamlandığında çağrılacak isteğe bağlı işlev. done
iki bağımsız değişkenle çağrılır: Error nesnesi (null olabilir) ve AmqpReceiver nesnesi.
invokeDeviceMethod(string, DeviceMethodParams)
function invokeDeviceMethod(deviceId: string, methodParams: DeviceMethodParams): Promise<ResultWithIncomingMessage<any>>
Parametreler
- deviceId
-
string
- methodParams
- DeviceMethodParams
Döndürülenler
Promise<ResultWithIncomingMessage<any>>
invokeDeviceMethod(string, DeviceMethodParams, IncomingMessageCallback<any>)
Belirli bir cihaz veya modülde bir yöntemi çağırır.
function invokeDeviceMethod(deviceId: string, methodParams: DeviceMethodParams, done?: IncomingMessageCallback<any>)
Parametreler
- deviceId
-
string
Mevcut cihaz kimliğinin tanımlayıcısı.
- methodParams
- DeviceMethodParams
- done
-
IncomingMessageCallback<any>
Yöntem yürütmesinin sonucuyla çağırmak için isteğe bağlı geri çağırma.
invokeDeviceMethod(string, string, DeviceMethodParams)
function invokeDeviceMethod(deviceId: string, moduleId: string, methodParams: DeviceMethodParams): Promise<ResultWithIncomingMessage<any>>
Parametreler
- deviceId
-
string
- moduleId
-
string
- methodParams
- DeviceMethodParams
Döndürülenler
Promise<ResultWithIncomingMessage<any>>
invokeDeviceMethod(string, string, DeviceMethodParams, IncomingMessageCallback<any>)
function invokeDeviceMethod(deviceId: string, moduleId: string, methodParams: DeviceMethodParams, done: IncomingMessageCallback<any>)
Parametreler
- deviceId
-
string
- moduleId
-
string
- methodParams
- DeviceMethodParams
- done
-
IncomingMessageCallback<any>
open()
function open(): Promise<ResultWithIncomingMessage<Connected>>
Döndürülenler
Promise<ResultWithIncomingMessage<Connected>>
open(IncomingMessageCallback<Connected>)
IoT hub'ına bağlantıyı açar.
function open(done?: IncomingMessageCallback<Connected>)
Parametreler
- done
-
IncomingMessageCallback<Connected>
İşlem tamamlandığında çağrılacak isteğe bağlı işlev. done
bir Hata nesnesi bağımsız değişkeni geçirilir ve işlem başarıyla tamamlanırsa null olur.
send(string, Message | BufferConvertible)
function send(deviceId: string, message: Message | BufferConvertible): Promise<ResultWithIncomingMessage<MessageEnqueued>>
Parametreler
- deviceId
-
string
- message
-
Message | BufferConvertible
Döndürülenler
Promise<ResultWithIncomingMessage<MessageEnqueued>>
send(string, Message | BufferConvertible, IncomingMessageCallback<MessageEnqueued>)
Bir cihaza ileti gönderir.
function send(deviceId: string, message: Message | BufferConvertible, done?: IncomingMessageCallback<MessageEnqueued>)
Parametreler
- deviceId
-
string
Mevcut cihaz kimliğinin tanımlayıcısı.
- message
-
Message | BufferConvertible
Cihaza gönderilecek iletinin gövdesi.
İleti türünde değilse message
dönüştürülür.
- done
-
IncomingMessageCallback<MessageEnqueued>
İşlem tamamlandığında çağrılacak isteğe bağlı işlev. done
iki bağımsız değişkenle çağrılır: Bir Hata nesnesi (null olabilir) ve günlüğe kaydetme veya hata ayıklama için yararlı olan aktarıma özgü yanıt nesnesi.
setRetryPolicy(RetryPolicy)
İstemci tarafından ağ işlemlerini yeniden denemek için kullanılan ilkeyi ayarlayın.
function setRetryPolicy(policy: RetryPolicy)
Parametreler
- policy
-
RetryPolicy
(örneğin, açma, gönderme vb.) işlemleri yeniden denemek için kullanılan ilke. SDK 2 "yerleşik" ilkeyle birlikte gelir: ExponentialBackoffWithJitter (varsayılan) ve NoRetry (herhangi bir yeniden deneme biçimini iptal etmek için). Kullanıcı, 2 yöntem uyguladığı sürece kendi nesnesini de geçirebilir: - shouldRetry(err: Error): boolean : bir işlemin hata türüne göre yeniden denenip denenmeyeceğini gösterir - nextRetryTimeout(retryCount: number, throttled: boolean): number: geçmiş deneme sayısına (retryCount) ve hatanın azaltma hatası olup olmamasına bağlı olarak yeniden denemeden önce beklenmesi gereken süreyi (milisaniye cinsinden) döndürür.
Devralınan Yöntemin Ayrıntıları
addAbortListener(AbortSignal, (event: Event) => void)
Sağlanan signal
üzerindeki olayı bir kez abort
dinler.
Durdurma sinyallerinde olayı dinlemek abort
güvenli değildir ve sinyale sahip başka bir üçüncü taraf çağırabileceğinden e.stopImmediatePropagation()
kaynak sızıntılarına yol açabilir. Ne yazık ki Node.js web standardını ihlal edeceğinden bunu değiştiremezsiniz. Ayrıca, özgün API dinleyicileri kaldırmayı unutmayı kolaylaştırır.
Bu API, dinleyicinin çalışmasını engellemeyen olayı stopImmediatePropagation
dinleyerek bu iki sorunu çözerek Node.js API'lerinde s'lerin güvenli bir şekilde kullanılmasına AbortSignal
olanak tanır.
Aboneliğinin daha kolay kaldırılabilmesi için atılabilir bir değer döndürür.
import { addAbortListener } from 'node:events';
function example(signal) {
let disposable;
try {
signal.addEventListener('abort', (e) => e.stopImmediatePropagation());
disposable = addAbortListener(signal, (e) => {
// Do something when signal is aborted.
});
} finally {
disposable?.[Symbol.dispose]();
}
}
static function addAbortListener(signal: AbortSignal, resource: (event: Event) => void): Disposable
Parametreler
- signal
-
AbortSignal
- resource
-
(event: Event) => void
Döndürülenler
Disposable
Dinleyiciyi kaldıran atılabilir abort
.
Devralınan EventEmitter.addAbortListener
addListener<K>(string | symbol, (args: any[]) => void)
için emitter.on(eventName, listener)
diğer ad.
function addListener<K>(eventName: string | symbol, listener: (args: any[]) => void): Client
Parametreler
- eventName
-
string | symbol
- listener
-
(args: any[]) => void
Döndürülenler
Devralınan EventEmitter.addListener
emit<K>(string | symbol, AnyRest)
Adlı olayeventName
için kaydedilen dinleyicilerin her birini, kaydedildikleri sırayla zaman uyumlu olarak çağırır ve sağlanan bağımsız değişkenleri her birine geçirir.
Olayın dinleyicileri varsa, false
aksi takdirde döndürürtrue
.
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<K>(eventName: string | symbol, args: AnyRest): boolean
Parametreler
- eventName
-
string | symbol
- args
-
AnyRest
Döndürülenler
boolean
Devralınan EventEmitter.emit
eventNames()
Vericinin dinleyicileri kaydettiği olayları listeleyen bir dizi döndürür. Dizideki değerler dize veya Symbol
değerlerdir.
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)[]
Döndürülenler
(string | symbol)[]
Devralınan EventEmitter.eventNames
getEventListeners(EventEmitter<DefaultEventMap> | _DOMEventTarget, string | symbol)
adlı eventName
olay için dinleyici dizisinin bir kopyasını döndürür.
s için EventEmitter
bu, vericide çağırma .listeners
ile tam olarak aynı şekilde davranır.
için EventTarget
, olay hedefi için olay dinleyicilerini edinmenin tek yolu budur. Bu, hata ayıklama ve tanılama amacıyla kullanışlıdır.
import { getEventListeners, EventEmitter } from 'node:events';
{
const ee = new EventEmitter();
const listener = () => console.log('Events are fun');
ee.on('foo', listener);
console.log(getEventListeners(ee, 'foo')); // [ [Function: listener] ]
}
{
const et = new EventTarget();
const listener = () => console.log('Events are fun');
et.addEventListener('foo', listener);
console.log(getEventListeners(et, 'foo')); // [ [Function: listener] ]
}
static function getEventListeners(emitter: EventEmitter<DefaultEventMap> | _DOMEventTarget, name: string | symbol): Function[]
Parametreler
- emitter
-
EventEmitter<DefaultEventMap> | _DOMEventTarget
- name
-
string | symbol
Döndürülenler
Function[]
Devralınan EventEmitter.getEventListeners
getMaxListeners()
defaultMaxListeners tarafından emitter.setMaxListeners(n)
ayarlanan veya varsayılan olarak ayarlanan geçerli en yüksek dinleyici değerini EventEmitter
döndürür.
function getMaxListeners(): number
Döndürülenler
number
Devralınan EventEmitter.getMaxListeners
getMaxListeners(EventEmitter<DefaultEventMap> | _DOMEventTarget)
Şu anda ayarlanmış en fazla dinleyici miktarını döndürür.
s için EventEmitter
bu, vericide çağırma .getMaxListeners
ile tam olarak aynı şekilde davranır.
için EventTarget
bu, olay hedefi için en fazla olay dinleyicilerini edinmenin tek yoludur. Tek bir EventTarget üzerindeki olay işleyicilerinin sayısı maksimum kümeyi aşarsa, EventTarget bir uyarı yazdırır.
import { getMaxListeners, setMaxListeners, EventEmitter } from 'node:events';
{
const ee = new EventEmitter();
console.log(getMaxListeners(ee)); // 10
setMaxListeners(11, ee);
console.log(getMaxListeners(ee)); // 11
}
{
const et = new EventTarget();
console.log(getMaxListeners(et)); // 10
setMaxListeners(11, et);
console.log(getMaxListeners(et)); // 11
}
static function getMaxListeners(emitter: EventEmitter<DefaultEventMap> | _DOMEventTarget): number
Parametreler
- emitter
-
EventEmitter<DefaultEventMap> | _DOMEventTarget
Döndürülenler
number
Devralınan EventEmitter.getMaxListeners
listenerCount(EventEmitter<DefaultEventMap>, string | symbol)
Uyarı
Bu API artık kullanım dışıdır.
Since v3.2.0 - Use listenerCount
instead.
Verilen emitter
üzerinde kayıtlı verilen eventName
için dinleyici sayısını döndüren bir sınıf yöntemi.
import { EventEmitter, listenerCount } from 'node:events';
const myEmitter = new EventEmitter();
myEmitter.on('event', () => {});
myEmitter.on('event', () => {});
console.log(listenerCount(myEmitter, 'event'));
// Prints: 2
static function listenerCount(emitter: EventEmitter<DefaultEventMap>, eventName: string | symbol): number
Parametreler
- emitter
-
EventEmitter<DefaultEventMap>
Sorguya yayımlayıcı
- eventName
-
string | symbol
Olay adı
Döndürülenler
number
Devralınan EventEmitter.listenerCount
listenerCount<K>(string | symbol, Function)
adlı eventName
olayı dinleyen dinleyici sayısını döndürür.
Sağlanırsa listener
, dinleyicinin olay dinleyicileri listesinde kaç kez bulunduğunu döndürür.
function listenerCount<K>(eventName: string | symbol, listener?: Function): number
Parametreler
- eventName
-
string | symbol
Dinlenen olayın adı
- listener
-
Function
Olay işleyici işlevi
Döndürülenler
number
Devralınan EventEmitter.listenerCount
listeners<K>(string | symbol)
adlı eventName
olay için dinleyici dizisinin bir kopyasını döndürür.
server.on('connection', (stream) => {
console.log('someone connected!');
});
console.log(util.inspect(server.listeners('connection')));
// Prints: [ [Function] ]
function listeners<K>(eventName: string | symbol): Function[]
Parametreler
- eventName
-
string | symbol
Döndürülenler
Function[]
Devralınan EventEmitter.listeners
off<K>(string | symbol, (args: any[]) => void)
için emitter.removeListener()
diğer ad.
function off<K>(eventName: string | symbol, listener: (args: any[]) => void): Client
Parametreler
- eventName
-
string | symbol
- listener
-
(args: any[]) => void
Döndürülenler
Devralınan EventEmitter.off
on(EventEmitter<DefaultEventMap>, string, StaticEventEmitterOptions)
import { on, EventEmitter } from 'node:events';
import process from 'node:process';
const ee = new EventEmitter();
// Emit later on
process.nextTick(() => {
ee.emit('foo', 'bar');
ee.emit('foo', 42);
});
for await (const event of on(ee, 'foo')) {
// The execution of this inner block is synchronous and it
// processes one event at a time (even with await). Do not use
// if concurrent execution is required.
console.log(event); // prints ['bar'] [42]
}
// Unreachable here
Olayları yineleyen eventName
bir AsyncIterator
döndürür. yayarsa EventEmitter
'error'
atar. Döngüden çıkarken tüm dinleyicileri kaldırır. value
Her yineleme tarafından döndürülen, yayılan olay bağımsız değişkenlerinden oluşan bir dizidir.
, AbortSignal
olayları beklemeyi iptal etmek için kullanılabilir:
import { on, EventEmitter } from 'node:events';
import process from 'node:process';
const ac = new AbortController();
(async () => {
const ee = new EventEmitter();
// Emit later on
process.nextTick(() => {
ee.emit('foo', 'bar');
ee.emit('foo', 42);
});
for await (const event of on(ee, 'foo', { signal: ac.signal })) {
// The execution of this inner block is synchronous and it
// processes one event at a time (even with await). Do not use
// if concurrent execution is required.
console.log(event); // prints ['bar'] [42]
}
// Unreachable here
})();
process.nextTick(() => ac.abort());
static function on(emitter: EventEmitter<DefaultEventMap>, eventName: string, options?: StaticEventEmitterOptions): AsyncIterableIterator<any>
Parametreler
- emitter
-
EventEmitter<DefaultEventMap>
- eventName
-
string
Dinlenen olayın adı
- options
-
StaticEventEmitterOptions
Döndürülenler
AsyncIterableIterator<any>
tarafından yayılan olayları yineleyen eventName
emitter
Devralınan EventEmitter.on
on<K>(string | symbol, (args: any[]) => void)
listener
adlı eventName
olay için işlevi dinleyiciler dizisinin sonuna ekler. öğesinin zaten eklenip eklenmediğini listener
görmek için denetim yapılmaz. aynı ve birleşimini eventName
listener
geçen birden çok çağrı, birden çok kez eklenmesine ve çağrılmasını listener
sağlar.
server.on('connection', (stream) => {
console.log('someone connected!');
});
Çağrıların EventEmitter
zincirlenebilmesi için öğesine bir başvuru döndürür.
Varsayılan olarak, olay dinleyicileri eklendikleri sırayla çağrılır. yöntemi,emitter.prependListener()
olay dinleyicisini dinleyici dizisinin başına eklemek için alternatif olarak kullanılabilir.
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<K>(eventName: string | symbol, listener: (args: any[]) => void): Client
Parametreler
- eventName
-
string | symbol
Olayın adı.
- listener
-
(args: any[]) => void
Geri çağırma işlevi
Döndürülenler
Devralınan EventEmitter.on
once(EventEmitter<DefaultEventMap>, string | symbol, StaticEventEmitterOptions)
Belirtilen olayı yaydığında EventEmitter
yerine getiren veya beklerken yaydığında 'error'
reddedilen EventEmitter
bir Promise
oluşturur.
, Promise
verilen olaya yayılan tüm bağımsız değişkenlerin bir dizisiyle çözülür.
Bu yöntem kasıtlı olarak geneldir ve özel'error'
olay semantiği olmayan ve olayı dinlemeyen 'error'
web platformu EventTarget arabirimiyle çalışır.
import { once, EventEmitter } from 'node:events';
import process from 'node:process';
const ee = new EventEmitter();
process.nextTick(() => {
ee.emit('myevent', 42);
});
const [value] = await once(ee, 'myevent');
console.log(value);
const err = new Error('kaboom');
process.nextTick(() => {
ee.emit('error', err);
});
try {
await once(ee, 'myevent');
} catch (err) {
console.error('error happened', err);
}
Olayın özel işlemesi 'error'
yalnızca başka bir olayı beklemek için kullanıldığında kullanılır events.once()
. 'error'
olayının kendisini beklemek için kullanılırsaevents.once()
, özel işleme olmadan başka bir olay türü olarak değerlendirilir:
import { EventEmitter, once } from 'node:events';
const ee = new EventEmitter();
once(ee, 'error')
.then(([err]) => console.log('ok', err.message))
.catch((err) => console.error('error', err.message));
ee.emit('error', new Error('boom'));
// Prints: ok boom
, AbortSignal
olayı beklemeyi iptal etmek için kullanılabilir:
import { EventEmitter, once } from 'node:events';
const ee = new EventEmitter();
const ac = new AbortController();
async function foo(emitter, event, signal) {
try {
await once(emitter, event, { signal });
console.log('event emitted!');
} catch (error) {
if (error.name === 'AbortError') {
console.error('Waiting for the event was canceled!');
} else {
console.error('There was an error', error.message);
}
}
}
foo(ee, 'foo', ac.signal);
ac.abort(); // Abort waiting for the event
ee.emit('foo'); // Prints: Waiting for the event was canceled!
static function once(emitter: EventEmitter<DefaultEventMap>, eventName: string | symbol, options?: StaticEventEmitterOptions): Promise<any[]>
Parametreler
- emitter
-
EventEmitter<DefaultEventMap>
- eventName
-
string | symbol
- options
-
StaticEventEmitterOptions
Döndürülenler
Promise<any[]>
Devralınan EventEmitter.once
once(_DOMEventTarget, string, StaticEventEmitterOptions)
static function once(emitter: _DOMEventTarget, eventName: string, options?: StaticEventEmitterOptions): Promise<any[]>
Parametreler
- emitter
-
_DOMEventTarget
- eventName
-
string
- options
-
StaticEventEmitterOptions
Döndürülenler
Promise<any[]>
Devralınan EventEmitter.once
once<K>(string | symbol, (args: any[]) => void)
adlı eventName
olay için tek seferliklistener
bir işlev ekler. Bir sonraki tetiklendiğinde eventName
, bu dinleyici kaldırılır ve sonra çağrılır.
server.once('connection', (stream) => {
console.log('Ah, we have our first user!');
});
Çağrıların EventEmitter
zincirlenebilmesi için öğesine bir başvuru döndürür.
Varsayılan olarak, olay dinleyicileri eklendikleri sırayla çağrılır. yöntemi,emitter.prependOnceListener()
olay dinleyicisini dinleyici dizisinin başına eklemek için alternatif olarak kullanılabilir.
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<K>(eventName: string | symbol, listener: (args: any[]) => void): Client
Parametreler
- eventName
-
string | symbol
Olayın adı.
- listener
-
(args: any[]) => void
Geri çağırma işlevi
Döndürülenler
Devralınan EventEmitter.once
prependListener<K>(string | symbol, (args: any[]) => void)
listener
adlı eventName
olay için işlevi dinleyiciler dizisinin başına ekler. öğesinin zaten eklenip eklenmediğini listener
görmek için denetim yapılmaz. aynı ve birleşimini eventName
listener
geçen birden çok çağrı, birden çok kez eklenmesine ve çağrılmasını listener
sağlar.
server.prependListener('connection', (stream) => {
console.log('someone connected!');
});
Çağrıların EventEmitter
zincirlenebilmesi için öğesine bir başvuru döndürür.
function prependListener<K>(eventName: string | symbol, listener: (args: any[]) => void): Client
Parametreler
- eventName
-
string | symbol
Olayın adı.
- listener
-
(args: any[]) => void
Geri çağırma işlevi
Döndürülenler
Devralınan EventEmitter.prependListener
prependOnceListener<K>(string | symbol, (args: any[]) => void)
adlı olay eventName
için dinleyiciler dizisinin başınatek seferliklistener
bir işlev ekler. Bir sonraki tetiklendiğinde eventName
, bu dinleyici kaldırılır ve ardından çağrılır.
server.prependOnceListener('connection', (stream) => {
console.log('Ah, we have our first user!');
});
Çağrıların EventEmitter
zincirlenebilmesi için öğesine bir başvuru döndürür.
function prependOnceListener<K>(eventName: string | symbol, listener: (args: any[]) => void): Client
Parametreler
- eventName
-
string | symbol
Olayın adı.
- listener
-
(args: any[]) => void
Geri çağırma işlevi
Döndürülenler
Devralınan EventEmitter.prependOnceListener
rawListeners<K>(string | symbol)
adlı eventName
olay için dinleyici dizisinin, sarmalayıcılar da dahil olmak üzere bir kopyasını döndürür (örneğin, tarafından .once()
oluşturulanlar).
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<K>(eventName: string | symbol): Function[]
Parametreler
- eventName
-
string | symbol
Döndürülenler
Function[]
Devralınan EventEmitter.rawListeners
removeAllListeners(string | symbol)
Tüm dinleyicileri veya belirtilen eventName
dinleyicileri kaldırır.
Özellikle örnek başka bir bileşen veya modül (örneğin yuvalar veya dosya akışları) tarafından oluşturulduğunda kodun EventEmitter
başka bir yerine eklenen dinleyicileri kaldırmak kötü bir uygulamadır.
Çağrıların EventEmitter
zincirlenebilmesi için öğesine bir başvuru döndürür.
function removeAllListeners(eventName?: string | symbol): Client
Parametreler
- eventName
-
string | symbol
Döndürülenler
Devralınan EventEmitter.removeAllListeners
removeListener<K>(string | symbol, (args: any[]) => void)
adlıeventName
olay için belirtilen listener
öğesini dinleyici dizisinden kaldırır.
const callback = (stream) => {
console.log('someone connected!');
};
server.on('connection', callback);
// ...
server.removeListener('connection', callback);
removeListener()
en fazla bir dinleyici örneğini dinleyici dizisinden kaldırır. Belirtilen eventName
removeListener()
için dinleyici dizisine birden çok kez tek bir dinleyici eklendiyse, her örneği kaldırmak için birden çok kez çağrılmalıdır.
Bir olay yayımlandıktan sonra, yayma sırasında ona eklenen tüm dinleyiciler sırayla çağrılır. Bu, yadıktan sonra ve son dinleyici yürütmeyi bitirmeden önce yapılan veyaremoveListener()
removeAllListeners()
çağrılarının devam edendenemit()
kaldırılmayacağını gösterir. Sonraki olaylar beklendiği gibi davranır.
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
Dinleyiciler bir iç dizi kullanılarak yönetildiğinden, bu çağrı, dinleyici kaldırıldıktan sonra kaydedilen herhangi bir dinleyicinin konum dizinlerini değiştirir. Bu, dinleyicilerin çağrılma sırasını etkilemez, ancak yöntemi tarafından emitter.listeners()
döndürülen dinleyici dizisinin kopyalarının yeniden oluşturulması gerektiği anlamına gelir.
Tek bir işlev tek bir olay için birden çok kez işleyici olarak eklendiğinde (aşağıdaki örnekte olduğu gibi), removeListener()
en son eklenen örneği kaldırır. once('ping')
Örnekte dinleyici kaldırılır:
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');
Çağrıların EventEmitter
zincirlenebilmesi için öğesine bir başvuru döndürür.
function removeListener<K>(eventName: string | symbol, listener: (args: any[]) => void): Client
Parametreler
- eventName
-
string | symbol
- listener
-
(args: any[]) => void
Döndürülenler
Devralınan EventEmitter.removeListener
setMaxListeners(number)
Varsayılan olarak EventEmitter
, belirli bir olay için birden fazla 10
dinleyici eklenirse s bir uyarı yazdırır. Bu, bellek sızıntılarını bulmaya yardımcı olan kullanışlı bir varsayılan değerdir. yöntemi, emitter.setMaxListeners()
bu belirli EventEmitter
örnek için sınırın değiştirilmesine izin verir. Sınırsız sayıda dinleyiciyi belirtmek için değer (veya 0
) olarak ayarlanabilirInfinity
.
Çağrıların EventEmitter
zincirlenebilmesi için öğesine bir başvuru döndürür.
function setMaxListeners(n: number): Client
Parametreler
- n
-
number
Döndürülenler
Devralınan EventEmitter.setMaxListeners
setMaxListeners(number, (EventEmitter<DefaultEventMap> | _DOMEventTarget)[])
import { setMaxListeners, EventEmitter } from 'node:events';
const target = new EventTarget();
const emitter = new EventEmitter();
setMaxListeners(5, target, emitter);
static function setMaxListeners(n?: number, eventTargets: (EventEmitter<DefaultEventMap> | _DOMEventTarget)[])
Parametreler
- n
-
number
Negatif olmayan bir sayı. Olay başına EventTarget
en fazla dinleyici sayısı.
- eventTargets
-
(EventEmitter<DefaultEventMap> | _DOMEventTarget)[]
Devralınan EventEmitter.setMaxListeners
[captureRejectionSymbol]<K>(Error, string | symbol, AnyRest)
function [captureRejectionSymbol]<K>(error: Error, event: string | symbol, args: AnyRest)
Parametreler
- error
-
Error
- event
-
string | symbol
- args
-
AnyRest
Devralınan EventEmitter.__@captureRejectionSymbol@115