Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (erralytics) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

errAlytics

errAlytics é uma biblioteca leve e flexível para rastrear erros HTTP no navegador. Ela realiza uma requisição HEAD para a URL especificada (ou para a URL atual) e dispara eventos analíticos para ferramentas como o Google Tag Manager (via dataLayer – padrão) ou via gtag, conforme sua configuração.

Recursos

Monitoramento de Erros HTTP: Suporte para códigos de status comuns, como 400, 401, 403, 404, 408, 429, 500, 502, 503 e 504.
Disparo de Eventos Analíticos: Integração simples para disparar eventos no dataLayer (padrão) ou via gtag.
Configuração Personalizável: Permite sobrescrever o método de rastreamento e customizar os eventos disparados para cada código HTTP.
Compatibilidade UMD: Bundle gerado em formato UMD para uso em ambientes com módulos (ES/CommonJS) e via CDN.

Instalação

Via npm

npm install err-alytics

pnpm add err-alytics

Uso

Em um Projeto com Módulos (ES6/Node) Importe a classe e instancie-a, passando (opcionalmente) sua configuração personalizada. Por padrão, o método de rastreamento é o dataLayer.

import ErrAlytics from 'err-alytics';

const tracker = new ErrAlytics({
  // A configuração padrão já abrange:
  // 400: bad_request, 401: unauthorized, 403: forbidden, 404: page_not_found, 408: request_timeout,
  // 429: too_many_requests, 500: server_error, 502: bad_gateway, 503: service_unavailable, 504: gateway_timeout
  // Você pode sobrescrever ou adicionar novas configurações se necessário.
});

// Rastreia a URL atual (ou passe outra URL como parâmetro)
tracker.track().then((response) => {
  console.log('Status verificado:', response.status);
});

Usando via CDN

<!DOCTYPE html>
<html lang="pt-BR">
<head>
  <meta charset="UTF-8">
  <title>Exemplo errAlytics via CDN</title>
  <!-- Inclua o bundle UMD da lib -->
  <script src="https://cdn.jsdelivr.net/npm/err-alytics/dist/err-alytics.umd.js"></script>
</head>
<body>
  <script>
    // A lib estará disponível globalmente como HttpErrorTracker
    const tracker = new HttpErrorTracker({
      // Para usar gtag em vez de dataLayer, basta alterar:
      // trackingMethod: 'gtag'
    });
    tracker.track();
  </script>
</body>
</html>

TODO

[] Monitoramento de Erros JavaScript: Implementar uma camada adicional que capture erros JavaScript globais (por exemplo, via window.onerror ou window.addEventListener('error')) e dispare eventos analíticos, integrando essa funcionalidade à lib.