How to handle iframes in WKZombie?

WKZombie can't directly access iframe elements due to WebKit limitations, but it provides a swap function to switch web contexts, as shown in the README's example for pressing buttons inside iframes.

WKZombie vs Selenium for iOS automation?

WKZombie is Swift-native and integrates directly into iOS/macOS apps with functional chaining, while Selenium is cross-platform but heavier. Choose WKZombie for Apple-focused projects needing tight app integration, but Selenium for broader platform support.

Can WKZombie be used for large-scale web scraping?

No, it's not ideal for large-scale scraping due to WebKit's resource intensity and single-threaded nature. For high-volume tasks, server-side tools like Puppeteer or Scrapy are better suited.

How to take snapshots with WKZombie on iOS?

Register a snapshotHandler and use the `>>*` operator or snap command in action chains, as detailed in the README's snapshot section, which outputs UIImage objects for visual testing.

Is WKZombie compatible with Swift Package Manager?

Yes, SPM is supported, but building requires extra flags like `-Xlinker -lxml2` due to libxml2 dependencies, as noted in the installation instructions.

What happens if a WKZombie action times out?

Actions timeout after 30 seconds by default, configurable via timeoutInSeconds. Errors are handled in Result types, but debugging may require enabling logging or using the dump command.

Open-Awesome

WKZombie

MITSwift1.1.1

A Swift headless browser framework for iOS/OSX to automate website navigation, data collection, and testing without a UI.

GitHub

1.2k stars100 forks0 contributors

What is WKZombie?

WKZombie is a Swift framework that provides a headless web browser for iOS and macOS applications. It enables developers to programmatically navigate websites, collect data, and automate interactions without a graphical user interface, using WebKit's WKWebView for rendering and HTML parsing. This is particularly useful for web scraping, automated testing, and manipulating web content using JavaScript.

Target Audience

iOS and macOS developers who need to automate web interactions, such as those building apps for web scraping, automated testing, or data collection without relying on APIs. It is also suitable for developers interested in functional programming approaches in Swift.

Value Proposition

Developers choose WKZombie for its functional programming style with action chaining using operators like `>>>` and `===`, making asynchronous web automation code compact and readable. It offers a headless browser solution integrated directly into Swift apps, supporting features like JavaScript execution, snapshot support for visual testing, and authentication handling.

Overview

WKZombie is a Swift framework for iOS/OSX to navigate within websites and collect data without the need of User Interface or API, also known as Headless browser. It can be used to run automated tests / snapshots and manipulate websites using Javascript.

Use Cases

Best For

Automating web interactions in iOS/macOS apps, such as logging into websites and submitting forms programmatically.
Web scraping and data collection from websites that lack APIs, using HTML parsing and JavaScript execution.
Running automated tests on web content, including taking snapshots for visual testing on iOS.
Manipulating web pages dynamically through JavaScript within a native Swift application.
Handling authentication challenges like Basic Auth and self-signed certificates in automated web sessions.
Building command-line tools for web automation on macOS using Swift.

Not Ideal For

Cross-platform projects targeting Android, Windows, or web environments
High-performance, large-scale web scraping requiring lightweight, concurrent processes
Applications needing a visible browser UI for real-time user interactions
Teams without Swift expertise or unfamiliar with functional programming concepts

Pros & Cons

Pros

Functional Action Chaining

Uses operators like `>>>` and `===` for compact, readable asynchronous code, as shown in the README's automation examples that chain actions like open, click, and submit.

Native iOS/macOS Integration

Leverages WebKit's WKWebView for headless browsing within Swift apps, enabling features like snapshot support for visual testing on iOS and seamless app embedding.

JavaScript Execution Support

Allows running custom JavaScript to manipulate or extract data, demonstrated in README snippets for tasks like retrieving page titles or interacting with elements.

Authentication Handling

Supports challenges like Basic Auth and self-signed certificates via a configurable authenticationHandler, with code examples provided in the documentation.

Cons

Outdated HTML Parsing

Relies on hpple/libxml2 for parsing, which the TODOs section admits is not 'Swifty' and plans to replace, potentially limiting modern Swift compatibility.

WebKit Inherited Limitations

Struggles with iframe access, requiring a workaround swap function, and inherits WebKit's performance overhead, making it less suitable for heavy concurrent tasks.

Setup Complexity

Command-line usage requires specific build flags like `-Xcc -I/usr/include/libxml2`, and integration issues like Result type collisions with Alamofire add extra steps.

Frequently Asked Questions

Related Projects

NetNewsWire

RSS reader for macOS and iOS.

Stars9,985

Forks689

Last commit3 days ago

SwiftSoup

SwiftSoup: Pure Swift HTML Parser, with best of DOM, CSS, and jquery (Supports Linux, iOS, Mac, tvOS, watchOS)

Stars5,075

Forks383

Last commit1 month ago

Kanna

Kanna(鉋) is an XML/HTML parser for Swift.

Stars2,487

Forks221

Last commit2 months ago

FeedKit

FeedKit is a Swift library for Reading and Generating RSS, Atom, and JSON feeds.

Stars1,324

Forks198