Skip to content

Repository files navigation

FakeWebKit

A lightweight ( 520 lines of code ) drop-in WebKit wrapper for tvOS, supporting user scripts, JS message handlers, and cookies — no WebKit dependency.

Notice:FakeWebView uses UIWebView internally, which is a private API on tvOS. Use with caution as it may be rejected by App Store review.

Features

  • Drop-in replacement for WKWebView on tvOS
  • User scripts injection (atDocumentStart / atDocumentEnd)
  • JavaScript message handlers via window.webkit.messageHandlers
  • Cookie management via WKCookieStore
  • Supports custom user agent and basic navigation delegate callbacks
  • ...

Installation

Add the package via Swift Package Manager:

In Xcode: File > Swift Packages > Add Package Dependency

https://github.com/undeadd/FakeWebKit.git

Usage

Use it just like the normal WKWwebView from Webkit:

#if os(tvOS)import FakeWebKit
#elseimport WebKit
#endif
// Add a JS message handler
letconfiguration=WKWebViewConfiguration()
configuration.userContentController.add(MyMessageHandler(), name:"scriptTest")
// Create the WKWebView
letwebView=WKWebView(frame:.zero, configuration: configuration)
// Inject a user script
lettestScript=WKUserScript(
source:""" (function() { if (window.webkit?.messageHandlers?.scriptTest?.postMessage) { window.webkit.messageHandlers.scriptTest.postMessage("Hello from JS"); } })();""",
injectionTime:.atDocumentEnd,
forMainFrameOnly:true)
configuration.userContentController.addUserScript(testScript)
// Load a URL
webView.load(URLRequest(url:URL(string:"https://example.com")!))

About

A lightweight drop-in WebKit wrapper for tvOS, supporting user scripts, JS message handlers, and cookies — no WebKit dependency.

Resources

Stars

4 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages