eventemitter2 NPM (Como funciona para desenvolvedores)

Aprimore a funcionalidade da classe nativa EventEmitter com o EventEmitter2 , um poderoso módulo de manipulação de eventos for Node.js Para lidar com estruturas complexas orientadas a eventos de forma mais eficaz, oferece uma série de recursos poderosos. Os eventos com curinga e os eventos com expressões regulares são duas funcionalidades importantes que permitem acionamentos de eventos mais flexíveis com base em padrões, além do agrupamento e processamento de inúmeros eventos relacionados usando namespaces. A capacidade do EventEmitter2 de suportar múltiplos ouvintes para um único evento permite priorizar ouvintes para lidar com diferentes ações desencadeadas pelo mesmo evento.

Ele também fornece espaços de nomes de eventos, que ajudam a organizar e classificar eventos, facilitando o gerenciamento e a depuração de sistemas complexos. Os listeners assíncronos, essenciais para gerenciar ações não bloqueantes em aplicações Node.js , também são suportados pela biblioteca de métodos de emissão de eventos. Devido a essas características, o EventEmitter2 é especialmente benéfico para aplicações online de grande escala, jogos e sistemas em tempo real que necessitam de gerenciamento de eventos confiável. O EventEmitter2, que é uma extensão da classe EventEmitter padrão, oferece aos programadores recursos robustos para escrever código mais escalável e de fácil manutenção.

A classe EventEmitter integrada no Node.js foi aprimorada com o robusto pacote de manipulação de eventos EventEmitter2. As principais características que diferenciam o EventEmitter2 são as seguintes:

Eventos Wildcard

Permite o uso de padrões curinga para eventos específicos, a fim de lidar e agrupar diversos eventos relacionados. Isso é útil para uma gestão de eventos mais hierárquica e estruturada.

Eventos de Expressão Regular

Permite o acionamento de eventos de acordo com padrões de expressões regulares, proporcionando maior flexibilidade no gerenciamento de eventos.

Vários ouvintes

Permite associar mais de um ouvinte a um evento. É possível obter um controle mais preciso sobre a sequência de execução dos listeners, permitindo que cada listener tenha uma prioridade.

Espaços de nomes de eventos

Simplifica a gestão e a depuração de sistemas complexos, facilitando a utilização de namespaces para a organização e classificação de eventos.

Ouvintes assíncronos

Permite ações não bloqueantes, essenciais para aplicações de alto desempenho, ao suportar ouvintes de eventos assíncronos.

Manipulação do Ouvinte

Oferece maneiras eficazes de adicionar, remover e gerenciar ouvintes.

Controle de Emissões de Eventos

Impede vazamentos de memória em programas longos, permitindo o controle sobre o número de ouvintes de um evento e a capacidade de restringir o número de vezes que um evento é ouvido.

Borbulhamento de evento

Permite que os eventos se propaguem em uma hierarquia, suportando o bubbling de eventos, que é comparável à forma como os eventos se propagam no DOM dos navegadores da web.

Otimização de desempenho

Otimizado para desempenho, é adequado para aplicações de alto tráfego onde é necessário um processamento de eventos rápido e eficaz.

Avisos detalhados de vazamento de memória

Ajuda os desenvolvedores a manterem seus aplicativos saudáveis, alertando-os sobre possíveis vazamentos de memória quando muitos ouvintes são adicionados a um único evento.

Instale o EventEmitter2

O primeiro passo é instalar o pacote EventEmitter2 usando o npm. Com o terminal aberto, digite o seguinte comando:

npm install eventemitter2

npm install eventemitter2

Importar e configurar o EventEmitter2

Em seguida, importe o EventEmitter2 para o seu programa Node.js e modifique-o de acordo com suas necessidades. Esta é uma ilustração de uma configuração simples do EventEmitter2:

const EventEmitter2 = require('eventemitter2').EventEmitter2;

// Configure EventEmitter2 with options
const eventEmitter = new EventEmitter2({
  wildcard: true,         // Allows use of wildcards.
  delimiter: '.',         // The delimiter used to segment namespaces.
  newListener: false,     // If true, the `newListener` event is emitted when new listeners are added.
  maxListeners: 20,       // Maximum number of listeners per event.
  verboseMemoryLeak: true // Show warnings if potential memory leaks are detected.
});

// Define an example listener for a wildcard event
eventEmitter.on('user.*', (data) => {
  console.log('User event:', data);
});

Emitir eventos

Após configurar o emissor de eventos, você pode começar a enviar eventos e observar como os destinatários reagem. Para emitir eventos, siga estes passos:

// Emit a user login event.
eventEmitter.emit('user.login', { username: 'john_doe' });

// Emit a user logout event.
eventEmitter.emit('user.logout', { username: 'john_doe' });

Adicionar e remover ouvintes

O mesmo evento permite adicionar e remover ouvintes conforme necessário. É assim que se faz:

// Define a specific listener
const loginListener = (data) => {
  console.log('User logged in:', data);
};

// Add the login listener to the user.login event
eventEmitter.on('user.login', loginListener);

// Emit the login event
eventEmitter.emit('user.login', { username: 'jane_doe' });

// Remove the login listener
eventEmitter.off('user.login', loginListener);

// Emit the login event again to show that the listener has been removed
eventEmitter.emit('user.login', { username: 'jane_doe' });

Utilizando ouvintes assíncronos

O EventEmitter2 oferece suporte a listeners assíncronos, o que é vantajoso ao gerenciar operações com uso intensivo de E/S ou outros processos assíncronos:

// Define an asynchronous listener
eventEmitter.on('file.upload', async (data) => {
  await new Promise((resolve) => setTimeout(resolve, 2000)); // Simulate async operation
  console.log('File uploaded:', data);
});

// Emit the file upload event
eventEmitter.emit('file.upload', { filename: 'example.txt' });

Tratamento de erros

eventEmitter.on('error', (err) => {
  console.error('An error occurred:', err);
});

// Emit an error event
eventEmitter.emit('error', new Error('Something went wrong!'));

const EventEmitter2 = require('eventemitter2').EventEmitter2;

// Create a new EventEmitter2 instance
const eventEmitter = new EventEmitter2({
  wildcard: true,
  delimiter: '.',
  newListener: false,
  maxListeners: 20,
  verboseMemoryLeak: true
});

// Add listeners
eventEmitter.on('user.*', (data) => {
  console.log('User event:', data);
});

const loginListener = (data) => {
  console.log('User logged in:', data);
};

eventEmitter.on('user.login', loginListener);

eventEmitter.on('file.upload', async (data) => {
  await new Promise((resolve) => setTimeout(resolve, 2000));
  console.log('File uploaded:', data);
});

eventEmitter.on('error', (err) => {
  console.error('An error occurred:', err);
});

// Emit events
eventEmitter.emit('user.login', { username: 'john_doe' });
eventEmitter.emit('user.logout', { username: 'john_doe' });
eventEmitter.emit('file.upload', { filename: 'example.txt' });

// Emit an error event
eventEmitter.emit('error', new Error('Something went wrong!'));

// Remove listeners
eventEmitter.off('user.login', loginListener);

// Emit the login event again
eventEmitter.emit('user.login', { username: 'jane_doe' });

O que é o IronPDF?

IronPDF é uma poderosa biblioteca Node.js que visa produzir páginas PDF de qualidade excepcional a partir de texto HTML. Sem comprometer o conteúdo original da web, ele agiliza o processo de conversão de arquivos HTML, CSS e outros arquivos JavaScript em PDFs formatados corretamente. Para aplicações web que precisam gerar documentos dinâmicos e imprimíveis, como relatórios, faturas e certificados, esta é uma ferramenta muito útil.

Configurações de página personalizáveis, cabeçalhos, rodapés e a possibilidade de adicionar fontes e imagens são apenas algumas das funcionalidades do IronPDF. Ele consegue lidar com estilos e layouts complexos para garantir que cada PDF de saída de teste esteja em conformidade com o layout exigido. Além disso, o IronPDF gerencia a execução de JavaScript dentro do HTML, permitindo a renderização precisa de informações dinâmicas e interativas.

Funcionalidades do IronPDF

Geração de PDF a partir de HTML

Converter JavaScript, HTML e CSS para PDF. O IronPDF oferece suporte a media queries e design responsivo, dois padrões web contemporâneos. Útil para decorar dinamicamente relatórios em PDF, faturas e documentos com HTML e CSS.

Edição de PDF

É possível adicionar texto, fotos e outros conteúdos a arquivos PDF preexistentes. Extrair texto e imagens de arquivos PDF, combinar vários PDFs em um único arquivo e dividir arquivos PDF em vários documentos separados. Inclua marcas d'água, anotações, cabeçalhos e rodapés.

Desempenho e confiabilidade

Alto desempenho e confiabilidade são qualidades desejáveis ​​em projetos de ambientes industriais. Gerencia grandes conjuntos de documentos com facilidade.

Instale o IronPDF

Instale o pacote IronPDF para obter as ferramentas necessárias para trabalhar com PDFs em projetos Node.js

npm install @ironsoftware/ironpdf

npm install @ironsoftware/ironpdf