# Safari Extension

> Safari Web Extension: SFSafariExtensionHandler, content scripts, web resources, native-web messaging. Use when building a Safari browser extension, injecting content scripts into web pages, or communicating between native app and Safari. Triggers: Safari extension, SFSafariExtensionHandler, content script, browser extension.

- Skill: `abdullah4ai/safari-extension-2` (Agent Skill)
- Install (CLI): `npx skillmds@latest add abdullah4ai/safari-extension-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/abdullah4ai/safari-extension-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: abdullah4ai (https://skillmd.com/u/abdullah4ai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/abdullah4ai/safari-extension-2

---

# Safari Extension

SAFARI WEB EXTENSION:
SETUP: Requires separate extension target (kind: "safari" in plan extensions array).
Safari Web Extensions use web technologies (JS/HTML/CSS) plus a native Swift wrapper.

SWIFT EXTENSION HANDLER (optional — for native communication):
class SafariExtensionHandler: SFSafariExtensionHandler {
    // Called when toolbar button is clicked
    override func toolbarItemClicked(in window: SFSafariWindow) {
        window.getActiveTab { tab in
            tab?.getActivePage { page in
                page?.dispatchMessageToScript(withName: "buttonClicked", userInfo: [:])
            }
        }
    }

    // Receive messages from JavaScript content scripts
    override func messageReceived(withName messageName: String, from page: SFSafariPage, userInfo: [String: Any]?) {
        // Handle message from JS: page.dispatchMessageToExtension(...)
    }
}

INFO.PLIST KEYS (extension):
NSExtensionPrincipalClass: $(PRODUCT_MODULE_NAME).SafariExtensionHandler
NSExtensionAttributes:
  SFSafariWebsiteAccess: { Level: All }

WEB EXTENSION RESOURCES (in extension bundle):
- manifest.json (Web Extension manifest v3)
- background.js (service worker)
- content.js (injected into pages)
- popup.html (toolbar popup)

ENABLE IN SAFARI: User must enable in Safari → Settings → Extensions.