chrome-network-logger

Chrome Network Logger

A simple npm module for logging fetch/XHR network requests in Chrome extensions.

Installation

npm install chrome-network-logger

Quick Start

1. Basic Usage

import { createNetworkLogger } from 'chrome-network-logger';

// Create logger
const logger = createNetworkLogger();

// Start logging
await logger.start();

// Stop logging
await logger.stop();

2. With Options

import { createNetworkLogger } from 'chrome-network-logger';

const logger = createNetworkLogger({
  logRequests: true,
  logResponses: true,
  logHeaders: false,        // Don't log headers
  logPostData: true,
  filterUrls: ['api', 'ajax']  // Only log URLs containing 'api' or 'ajax'
});

await logger.start();

3. In Your Chrome Extension

// background.js
import { createNetworkLogger } from 'chrome-network-logger';

export default defineBackground(() => {
  const logger = createNetworkLogger();
  
  // Start logging when extension loads
  logger.start();
  
  // Your other extension code...
});

API

createNetworkLogger(options?)

Creates a new network logger instance.

Options:

• logRequests (boolean): Log requests (default: true)
• logResponses (boolean): Log responses (default: true)
• logHeaders (boolean): Include headers in logs (default: true)
• logPostData (boolean): Include POST data in logs (default: true)
• filterUrls (string[]): Only log URLs containing these strings

Methods

• start(): Start network logging
• stop(): Stop network logging
• isRunning(): Check if logging is active
• getAttachedTabs(): Get list of monitored tabs

Example Output

[2024-01-15T11:30:00.000Z] Tab 123 (LinkedIn Jobs) - FETCH/XHR REQUEST: {
  tabId: 123,
  tabTitle: "LinkedIn Jobs",
  tabUrl: "https://www.linkedin.com/jobs/search",
  requestUrl: "https://www.linkedin.com/api/jobs/search",
  method: "POST",
  requestId: "12345",
  headers: {...},
  postData: "{\"keywords\":\"react developer\"}",
  timestamp: "2024-01-15T11:30:00.000Z"
}

Requirements

• Chrome Extension with debugger permission
• TypeScript support (optional)

License

MIT