.eslintrc-quick-reference.md

ESLint Quick Reference

Common Commands

npm run lint           # Lint all files
npm run lint:fix       # Auto-fix issues
npm run lint:modules   # Lint modules/ only
npm run lint:watch     # Watch mode

Quick Fixes

Unused Variable

// Add _ prefix
function handler(message, _sender, _sendResponse) { }

Service Worker Globals

// ❌ Don't use in background.js
window.addEventListener()
document.querySelector()

// ✅ Use instead
self.addEventListener()
chrome.scripting.executeScript()

Equality

// ❌ Don't use
if (x == y)

// ✅ Use
if (x === y)

Const vs Let

// ❌ Don't use
let x = 5;  // Never reassigned

// ✅ Use
const x = 5;

Disable Rules

// One line
// eslint-disable-next-line no-console
console.log('debug');

// Multiple lines
/* eslint-disable no-console */
console.log('line 1');
console.log('line 2');
/* eslint-enable no-console */

// Entire file
/* eslint-disable */

VS Code

• Auto-fix on save: Enabled by default
• Disable: Settings → "Code Actions On Save" → Turn off
• View errors: Problems panel (Cmd+Shift+M)

Severity

• 🔴 Error: Must fix (blocks build)
• 🟡 Warning: Should fix (doesn't block)
• ⚪ Off: Disabled