https://github.com/Naituw/WBWebViewConsole

In-App debug console for your UIWebView & WKWebView
https://github.com/Naituw/WBWebViewConsole

Last synced: about 1 month ago
JSON representation

In-App debug console for your UIWebView & WKWebView

• Host: GitHub
• URL: https://github.com/Naituw/WBWebViewConsole
• Owner: Naituw
• License: other
• Created: 2015-02-13T08:05:55.000Z (almost 10 years ago)
• Default Branch: master
• Last Pushed: 2017-08-08T12:20:38.000Z (over 7 years ago)
• Last Synced: 2024-11-05T18:56:57.315Z (about 1 month ago)
• Language: Objective-C
• Size: 859 KB
• Stars: 1,334
• Watchers: 44
• Forks: 124
• Open Issues: 7
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• Awesome-iOS - WBWebViewConsole - In-App debug console for your UIWebView & WKWebView (Tools)

README

        
# WBWebViewConsole [![Build Status](https://travis-ci.org/Naituw/WBWebViewConsole.svg)](https://travis-ci.org/Naituw/WBWebViewConsole)

WBWebViewConsole is an In-App debug console for your UIWebView && WKWebView



## Installation

WBWebViewConsole is available on [CocoaPods](http://cocoapods.org). Just add the following to your project Podfile:

```

pod 'WBWebViewConsole', '~> 1.0' 

```

Bugs are first fixed in master and then made available via a designated release. If you tend to live on the bleeding edge, you can use WBWebViewConsole from master with the following Podfile entry:

```

pod 'WBWebViewConsole', :git => 'https://github.com/Naituw/WBWebViewConsole.git'

```

## Setup

- Make your own `UIWebView` or `WKWebView` subclass, and implement all methods in `WBWebView` protocol

- Setup `JSBridge` and `console` when WebView inits

- If you are using `UIWebView`, inject userScript as early as possible after page loading. Otherwise, just use `WKUserScript` to implement.

- In `UIWebView`'s `webView:shouldStartLoadWithRequest:navigationType` or `WKWebView`'s `webView:decidePolicyForNavigationAction:decisionHandler`

  - Pass the request to `-[JSBridge handleWebViewRequest:]` and use the return value to decide whether the navigation should start

## Usage

- Use `WBWebViewConsole` to manage all messages

  - `addMessage:type:level:source:`

 	- add message for specific type, level and source

  - `clearMessage`

    - empty all messages

  - `sendMessage`

    - input (eval) script

  - `storeCurrentSelectedElementToJavaScriptVariable:completion:`

    - save current selected element to a js variable

- Use `WBWebDebugConsoleViewController` to display a `WBWebViewConsole`

  - `initWithConsole:`

    - designated initializer for this class

  - `setInitialCommand:`

    - set the placeholder command

## License

WBWebViewConsole is BSD-licensed. see the `LICENSE` file.

The files in the `/Examples` directory are licensed under a separate license as specified in `Examples/README.md`.