☰

Userscript Logger Pro

Professional logging system for userscripts with history, colored labels and emoji support. Centralized logger for all your scripts.

As of 2025-10-26. See the latest version.

This script should not be not be installed directly. It is a library for other scripts to include with the meta directive // @require https://update.greatest.deepsurf.us/scripts/553735/1684000/Userscript%20Logger%20Pro.js

Author
MaxScorpy
Version
1.0.0
Created
2025-10-26
Updated
2025-10-26
Size
7.02 KB
License
MIT

📋 Short Description (for search)

Professional logging system for userscripts with colored console output, emoji support and log history. Centralized logger for all your scripts.

📝 Full Description

Userscript Logger Pro is a centralized logging library for userscripts that provides a unified, beautiful and powerful logging system.

✨ Features

  • 🎨 Colored Console Output - Different colors for each log level (debug, info, success, warning, error)
  • 🎭 Emoji Support - Visual identification with customizable emoji for your scripts
  • 📚 Log History - Stores all logs in memory with timestamps for debugging
  • 🔍 Filtering - Get logs by specific level or export all to JSON
  • 🌐 Universal - Works with all userscript managers (Tampermonkey, Violentmonkey, Greasemonkey)
  • 📦 Zero Dependencies - Lightweight, standalone library
  • 🚀 Easy to Use - Simple API, just 3 lines to get started

📖 Usage

// Step 1: Add @require to your userscript header
// @require https://greatest.deepsurf.us/scripts/YOUR_SCRIPT_ID/code/Userscript%20Logger%20Pro.user.js

// Step 2: Create logger instance
const logger = window.MaxScorpyLogger.createLogManager({
    scriptName: 'MY-SCRIPT',
    emoji: '🚀'
});

// Step 3: Start logging!
logger.info('Script started');
logger.success('Task completed successfully');
logger.warning('Be careful here');
logger.error('Something went wrong', errorObject);
logger.debug('Debug info', { variable: value });

🎯 Advanced Features

// Get log history
const allLogs = logger.getHistory();

// Get only errors
const errors = logger.getLogsByLevel('error');

// Export to JSON
const jsonLogs = logger.exportLogs();
console.log(jsonLogs);

// Clear history
logger.clearHistory();

🎨 Log Levels

  • 🔍 debug - Purple - Debug information
  • ℹ️ info - Blue - General information
  • ✅ success - Green - Successful operations
  • ⚠️ warning - Orange - Warnings
  • ❌ error - Red - Errors