Troubleshooting

The fixes that solve almost everything.

Source · docs/

Common symptoms

  • Extension not loading — clear cache, then reload in chrome://extensions/
  • Feature not working — open the console (right-click → Inspect) and look for [FocusTube] errors
  • Storage not updating — reload the tab after changing settings
  • A domain isn't blocking — check spelling; subdomains are covered automatically
  • Block page not showing — check the browser console for errors

Enable debug logs

// In src/content/core/logger.js
const DEBUG_LOGS = true;

// Output appears as:
// [FocusTube] [Module] message
javascript

Inspect storage

// From the extension's DevTools console:
chrome.storage.local.get(null, (data) =>
  console.log('All storage:', data)
);
javascript