Returns the current page URL.

const url = wizard.page.getURL();
console.log(url); // "https://github.com/NaniIsNano"

Returns the current page title.

Injects a CSS string into the current page. Applied immediately.

wizard.page.injectCSS(`
  body { background: #000 !important; color: #fff !important; }
  img  { filter: invert(1) hue-rotate(180deg); }
`);

Executes a JavaScript string in the context of the current page.

wizard.page.injectScript(`
  document.querySelectorAll('.ad').forEach(el => el.remove());
`);

Fires every time the user navigates to a new URL. Your callback receives the new URL. Only fires for URLs matching your manifest's match patterns.

wizard.page.onNavigate((url) => {
  if (url.includes('youtube.com')) {
    wizard.page.injectCSS('#masthead { display: none !important; }');
  }
});

Fires when a page finishes loading (DOM ready). Use this instead of onNavigate when you need the full DOM to be available before reading or injecting.

Adds a button to the browser toolbar. Returns a ButtonHandle you can use to update the badge, tooltip, or remove the button later.

Options

ButtonHandle methods

const btn = wizard.ui.addButton({
  icon: '🛡',
  tooltip: 'Wizard Adblocker',
  onClick: () => wizard.ui.notify('Clicked!')
});

// Live badge updates
btn.setBadge('42');
btn.setTooltip('42 blocks this session');

// Remove when done
btn.remove();

Shows a toast notification in the browser UI.

wizard.ui.notify('Tracker blocked!', { type: 'success' });
wizard.ui.notify('Filter lists out of date', { type: 'warn', duration: 5000 });

Returns the active color scheme (e.g. 'default', 'frutiger', 'retrowave', 'rose', 'emerald'). Useful for matching your extension's styles to the browser theme.

const theme = await wizard.ui.getTheme();
if (theme === 'retrowave') {
  // adapt accent colours…
}

Retrieves a stored value. Returns null if the key doesn't exist.

const enabled = await wizard.storage.get('darkMode');
if (enabled) applyDarkMode();

Stores a JSON-serializable value.

await wizard.storage.set('darkMode', true);
await wizard.storage.set('config', { theme: 'purple', count: 42 });

Deletes a stored key.

Deletes all data stored by your extension.

Returns the user's current privacy settings.

const p = await wizard.privacy.getSettings();
// {
//   trackerBlocking:   true,
//   doNotTrack:        true,
//   canvasSpoofing:    true,
//   webrtcProtection:  true,
//   referrerStripping: true,
//   clearOnExit:       true
// }

Returns true if the given domain is on the tracker blocklist.

await wizard.privacy.isTrackerBlocked('doubleclick.net'); // true
await wizard.privacy.isTrackerBlocked('github.com');      // false

Returns the total number of trackers blocked in the current session. For richer adblocker state, see wizard.adblock.

Fetch a URL from the main process. Returns a response object with .ok, .status, and .body (string). Use JSON.parse(body) for JSON responses.

const res = await wizard.net.fetch(
  'https://api.github.com/repos/NaniIsNano/wizard-browser'
);
if (res.ok) {
  const data = JSON.parse(res.body);
  console.log(data.stargazers_count);
}

POST JSON to a URL. Content-Type: application/json is set automatically; the body is auto-serialized.

const res = await wizard.net.post('https://api.example.com/events', {
  type: 'install',
  version: '1.0.0'
});

Returns the current state of the blocking engine.

const s = await wizard.adblock.getStatus();
if (s.enabled && s.ready) {
  console.log(`Active engine: ${s.source} · ${s.totalFilters.toLocaleString()} rules`);
}

Total trackers/ads blocked in the current session. Counted across all engines (Ghostery + uBO + static fallback).

const n = await wizard.adblock.getBlockedCount();
btn.setBadge(n > 999 ? Math.floor(n / 1000) + 'k' : String(n));

Opens the Wizard-native adblocker dashboard. Returns true if the call succeeded. The dashboard talks to whichever engine is currently active (Ghostery or uBO) and shows live blocked-request logs.

if (!wizard.adblock.openDashboard()) {
  wizard.ui.notify('Dashboard unavailable on this build.', { type: 'warn' });
}

Returns the state of the real uBlock Origin Chrome extension (loaded via session.loadExtension). The state field is one of 'idle' · 'downloading' · 'extracting' · 'loading' · 'active' · 'failed' · 'unsupported'.

Fires whenever the blocking engine status changes — filter lists refreshed, user toggled tracker blocking, uBO installed, etc. Use this to keep a live tooltip or badge in sync.

wizard.adblock.onStatus((s) => {
  btn.setTooltip(s.ready
    ? `${s.totalFilters} rules · ${s.source}`
    : 'Adblocker loading…');
});

Fires on uBlock Origin lifecycle changes (download progress, install success/failure, auto-update).