DSBridge for iOS

https://github.com/wendux/dsbridge-ios
Admin
DSBridge for iOS is a modern, cross-platform JavaScript bridge that enables synchronous or...
Tokens:9,975
Snippets:68
Trust Score:9
Update:1 year ago
Show doc for...
Tokens:
Raw
### Call Native APIs and Register JavaScript APIs using DSBridge.js

Source: https://github.com/wendux/dsbridge-ios/blob/master/README.md

Provides examples of how to interact with native functionalities from JavaScript using the DSBridge library. It covers calling synchronous and asynchronous native methods and registering JavaScript functions to be called by the native side.

```JavaScript
//cdn
//<script src="https://cdn.jsdelivr.net/npm/dsbridge@3.1.4/dist/dsbridge.js"> //</script>
//npm
//npm install dsbridge@3.1.4
var dsBridge=require("dsbridge")

//Call synchronously 
var str=dsBridge.call("testSyn","testSyn");

//Call asynchronously
dsBridge.call("testAsyn","testAsyn", function (v) {
  alert(v);
})

//Register javascript API for Native
 dsBridge.register('addValue',function(l,r){
     return l+r;
 })
```

--------------------------------

### Implement Synchronous and Asynchronous Native APIs in Objective-C

Source: https://github.com/wendux/dsbridge-ios/blob/master/README.md

Demonstrates how to implement native methods in an Objective-C class that can be called from JavaScript. Includes examples for both synchronous and asynchronous calls, with the latter using a JSCallback for results.

```Objective-C
#import "dsbridge.h" 
...
@implementation JsApiTest
//for synchronous invocation  
- (NSString *) testSyn:(NSString *) msg
{
    return [msg stringByAppendingString:@"[ syn call]"];
}
//for asynchronous invocation
- (void) testAsyn:(NSString *) msg :(JSCallback)completionHandler
{
    completionHandler([msg stringByAppendingString:@" [ asyn call]"],YES);
}
@end
```

--------------------------------

### Call Namespaced Objective-C API from JavaScript

Source: https://github.com/wendux/dsbridge-ios/blob/master/README.md

This JavaScript code demonstrates how to call Objective-C methods exposed through DSBridge using a namespace. It shows examples for both synchronous and asynchronous calls.

```javascript
// call echo.syn
var ret=dsBridge.call("echo.syn",{msg:" I am echoSyn call", tag:1})
alert(JSON.stringify(ret))
// call echo.asyn
dsBridge.call("echo.asyn",{msg:" I am echoAsyn call",tag:2},function (ret) {
      alert(JSON.stringify(ret));
})
```

--------------------------------

### Install DSBridge with CocoaPods

Source: https://github.com/wendux/dsbridge-ios/blob/master/README.md

This snippet shows how to add the DSBridge library to your iOS project using CocoaPods, a dependency manager for Swift and Objective-C projects.

```Shell
pod "dsBridge"
```

--------------------------------

### Install DSBridge via CocoaPods

Source: https://github.com/wendux/dsbridge-ios/blob/master/readme-chs.md

This snippet shows how to add the DSBridge library to your iOS project using CocoaPods, a dependency manager for Swift and Objective-C Cocoa projects.

```shell
pod "dsBridge"
```

--------------------------------

### Initialize and Use DSBridge in JavaScript

Source: https://github.com/wendux/dsbridge-ios/blob/master/readme-chs.md

This snippet illustrates how to initialize DSBridge in JavaScript, either via CDN or npm, and then how to call native methods (synchronous and asynchronous) and register JavaScript functions for native calls.

```JavaScript
//cdn方式引入初始化代码(中国地区慢，建议下载到本地工程)
//<script src="https://cdn.jsdelivr.net/npm/dsbridge@3.1.4/dist/dsbridge.js"> //</script>
//npm方式安装初始化代码
//npm install dsbridge@3.1.4
var dsBridge=require("dsbridge")

//同步调用
var str=dsBridge.call("testSyn","testSyn");

//异步调用
dsBridge.call("testAsyn","testAsyn", function (v) {
  alert(v);
})

//注册 javascript API 
dsBridge.register('addValue',function(l,r){
    return l+r;
})
```

--------------------------------

### Call Synchronous Method (Swift)

Source: https://github.com/wendux/dsbridge-ios/blob/master/dsbridgedemo/test.html

Illustrates making a synchronous call to a Swift native method prefixed with 'swift.testSyn' and displaying the result.

```javascript
function callSynSwift() { alert(dsBridge.call("swift.testSyn", "hello")) }
```

--------------------------------

### Register Namespace Asynchronous Methods

Source: https://github.com/wendux/dsbridge-ios/blob/master/dsbridgedemo/test.html

Registers asynchronous methods 'addValue' and 'getInfo' under the 'asyn' namespace, including a responseCallback for each.

```javascript
// namespace test for asyn functions dsBridge.registerAsyn("asyn", { tag: "asyn", addValue:function (r,l, responseCallback) { responseCallback(r+l); }, getInfo: function (responseCallback) { responseCallback({tag: this.tag, value:8}) } })
```

--------------------------------

### Call Synchronous Method

Source: https://github.com/wendux/dsbridge-ios/blob/master/dsbridgedemo/test.html

Demonstrates how to make a synchronous call to a native method named 'testSyn' with a string argument and display the returned value.

```javascript
function callSyn() { alert(dsBridge.call("testSyn", "Hello")) }
```

--------------------------------

### Register Namespace Synchronous Methods

Source: https://github.com/wendux/dsbridge-ios/blob/master/dsbridgedemo/test.html

Registers synchronous methods 'addValue' and 'getInfo' under the 'syn' namespace.

```javascript
// namespace test for syn functions dsBridge.register("syn", { tag: "syn", addValue:function (r,l) { return r+l; }, getInfo: function () { return {tag: this.tag, value:8} } })
```

--------------------------------

### Call Asynchronous Method

Source: https://github.com/wendux/dsbridge-ios/blob/master/dsbridgedemo/test.html

Shows how to make an asynchronous call to a native method named 'testAsyn' with a string argument and handle the response using a callback function.

```javascript
function callAsyn() { dsBridge.call("testAsyn","hello", function (v) { alert(v) }) }
```

--------------------------------

### Call Asynchronous Method (Swift)

Source: https://github.com/wendux/dsbridge-ios/blob/master/dsbridgedemo/test.html

Demonstrates an asynchronous call to a Swift native method prefixed with 'swift.testAsyn', including a callback to process the response.

```javascript
function callAsynSwift() { dsBridge.call("swift.testAsyn","hello", function (v) { alert(v) }) }
```

--------------------------------

### Call JavaScript API from Objective-C

Source: https://github.com/wendux/dsbridge-ios/blob/master/readme-chs.md

Demonstrates how to invoke a JavaScript API (registered using `dsBridge.register`) from your Objective-C code. It shows how to pass arguments and handle the response via a completion handler.

```Objective-C
[dwebview callHandler:@"addValue" arguments:@[@3,@4] completionHandler:^(NSNumber* value){
       NSLog(@"%@",value);
}];
```

--------------------------------

### Implement Native APIs in Objective-C

Source: https://github.com/wendux/dsbridge-ios/blob/master/readme-chs.md

Demonstrates how to create Objective-C classes to handle synchronous and asynchronous calls from JavaScript. Synchronous APIs return a value, while asynchronous APIs use a completion handler.

```Objective-C
#import "dsbridge.h" 
...
@implementation JsApiTest
//同步API 
- (NSString *) testSyn:(NSString *) msg
{
    return [msg stringByAppendingString:@"[ syn call]"];
}
//异步API
- (void) testAsyn:(NSString *) msg :(JSCallback)completionHandler
{
    completionHandler([msg stringByAppendingString:@" [ asyn call]"],YES);
}
@end
```

--------------------------------

### Implement Progress Callback in Objective-C

Source: https://github.com/wendux/dsbridge-ios/blob/master/README.md

This Objective-C code demonstrates how to implement a progress callback mechanism. It uses NSTimer to repeatedly send progress updates to JavaScript via a completion handler.

```objective-c
- ( void )callProgress:(NSDictionary *) args :(JSCallback)completionHandler
{
    value=10;
    hanlder=completionHandler;
    timer =  [NSTimer scheduledTimerWithTimeInterval:1.0
                                              target:self
                                            selector:@selector(onTimer:)
                                            userInfo:nil
                                             repeats:YES];
}
-(void)onTimer:t{
    if(value!=-1){
        hanlder([NSNumber numberWithInt:value--],NO);
    }else{
        hanlder(@"",YES);
        [timer invalidate];
    }
}
```

--------------------------------

### JavaScript Call Object-C API

Source: https://github.com/wendux/dsbridge-ios/blob/master/readme-chs.md

Demonstrates calling Object-C API objects from JavaScript using DSBridge. It shows how to invoke both synchronous ('syn') and asynchronous ('asyn') methods with arguments and callbacks.

```javascript
// call echo.syn
var ret=dsBridge.call("echo.syn",{msg:" I am echoSyn call", tag:1})
alert(JSON.stringify(ret))
// call echo.asyn
dsBridge.call("echo.asyn",{msg:" I am echoAsyn call",tag:2},function (ret) {
      alert(JSON.stringify(ret));
})
```

--------------------------------

### Objective-C API Signature Conventions for DSBridge

Source: https://github.com/wendux/dsbridge-ios/blob/master/README.md

Details the conventions for defining Objective-C methods that are exposed to JavaScript via DSBridge. It specifies the signature format for both synchronous and asynchronous API calls, including the use of JSCallback for asynchronous responses.

```Objective-C
// For synchronous API.
// **(id) handler:(id) msg**
// - The argument type can be any class type, but the type of return value can't be **void**.

// For asynchronous API.
// ** (void) handler:(id) arg :(JSCallback)completionHandler）**
// `JSCallback` is a block type:
// ```
// typedef void (^JSCallback)(NSString * _Nullable result,BOOL complete);
// ```

// Attention: API name can't start with "init", because it is reserved in OC class.
```

--------------------------------

### Basic CSS Styling

Source: https://github.com/wendux/dsbridge-ios/blob/master/dsbridgedemo/test.html

Provides basic CSS styling for a button element, including text alignment, background, color, padding, margin, font size, border radius, and box shadow.

```css
.btn { text-align: center; background: #eee; color: #000; padding: 20px; margin: 30px; font-size: 24px; border-radius: 4px; box-shadow: 4px 2px 10px #999; }
.btn:active { opacity: .7; box-shadow: 4px 2px 10px #555; }
```

--------------------------------

### Swift API Declaration for DSBridge

Source: https://github.com/wendux/dsbridge-ios/blob/master/readme-chs.md

Explains how to declare native APIs in Swift for use with DSBridge. Key requirements include the `@objc` annotation and using an underscore `_` to ignore the parameter name for the first argument.

```Swift
//必须给第一个参数前添加下划线"_"来显式忽略参数名。
@objc func testSyn( _ arg:String) -> String {
	return String(format:@"%@[Swift sync call:%@]", arg, "test")
}

@objc func testAsyn( _ arg:String, handler: (String, Bool)->Void) {
	handler(String(format:@"%@[Swift async call:%@]", arg, "test"), true)
}
```

--------------------------------

### Register Asynchronous Method 'startTimer'

Source: https://github.com/wendux/dsbridge-ios/blob/master/dsbridgedemo/test.html

Registers an asynchronous JavaScript function 'startTimer' that uses setInterval to call a responseCallback every second with an incrementing value, stopping after 5 seconds.

```javascript
dsBridge.registerAsyn('startTimer', function (responseCallback) { var t = 0; var timer = setInterval(function () { if (t == 5) { responseCallback(t) clearInterval(timer) } else { // if the 2nd argument is false, the java callback handler will be not removed! responseCallback(t++, false) } }, 1000) })
```

--------------------------------

### Call Asynchronous Method Without Argument

Source: https://github.com/wendux/dsbridge-ios/blob/master/dsbridgedemo/test.html

Demonstrates an asynchronous call to 'testNoArgAsyn' without arguments, using a callback to display the result.

```javascript
function callNoArgAsyn() { dsBridge.call("testNoArgAsyn", function (v) { alert(v) }); }
```

--------------------------------

### Register Native API Object with DWKWebView

Source: https://github.com/wendux/dsbridge-ios/blob/master/README.md

Shows how to add a custom Objective-C API object to a DWKWebView instance, making its methods accessible from JavaScript. The namespace parameter allows for optional namespacing of the registered APIs.

```Objective-C
DWKWebView * dwebview=[[DWKWebView alloc] initWithFrame:bounds];
// register api object without namespace
[dwebview addJavascriptObject:[[JsApiTest alloc] init] namespace:nil];
```

--------------------------------

### Call Namespace Asynchronous Method

Source: https://github.com/wendux/dsbridge-ios/blob/master/dsbridgedemo/test.html

Makes an asynchronous call to 'echo.asyn' within a namespace, providing arguments and a callback to handle the stringified response.

```javascript
function echoAsyn() { // call function with namespace dsBridge.call("echo.asyn",{msg:" I am echoAsyn call",tag:2},function (ret) { alert(JSON.stringify(ret)); }) }
```

--------------------------------

### Call JavaScript API with Completion Handler

Source: https://github.com/wendux/dsbridge-ios/blob/master/README.md

Allows calling JavaScript methods and optionally receiving a response via a completion handler. The completion handler is executed on the main thread. Namespaces can be included in the method name.

```objective-c
[dwebview callHandler:@"append" arguments:@[@"I",@"love",@"you"]
  completionHandler:^(NSString * _Nullable value) {
       NSLog(@"call succeed, append string is: %@",value);
}];
// call with namespace 'syn', More details to see the Demo project                    
[dwebview callHandler:@"syn.getInfo" completionHandler:^(NSDictionary * _Nullable value) {
        NSLog(@"Namespace syn.getInfo: %@",value);
}];
```

--------------------------------

### Call Namespace Synchronous Method

Source: https://github.com/wendux/dsbridge-ios/blob/master/dsbridgedemo/test.html

Executes a synchronous method 'echo.syn' within a namespace, passing an object with message and tag, and displays the stringified result.

```javascript
function echoSyn() { // call function with namespace var ret=dsBridge.call("echo.syn",{msg:" I am echoSyn call", tag:1}); alert(JSON.stringify(ret)) }
```

--------------------------------

### Register Native API Object with DWKWebView

Source: https://github.com/wendux/dsbridge-ios/blob/master/readme-chs.md

Shows how to register an instance of your native API class with a DWKWebView instance. This makes the native methods callable from JavaScript. You can optionally specify a namespace.

```Objective-C
DWKWebView * dwebview=[[DWKWebView alloc] initWithFrame:bounds];
// register api object without namespace
[dwebview addJavascriptObject:[[JsApiTest alloc] init] namespace:nil];
```

--------------------------------

### Call Method That Never Exists

Source: https://github.com/wendux/dsbridge-ios/blob/master/dsbridgedemo/test.html

Attempts to call a non-existent method 'testNever' with arguments, likely to demonstrate error handling or default behavior.

```javascript
function callNever() { alert(dsBridge.call("testNever", {msg: "testSyn"})) }
```

--------------------------------

### Call Synchronous Method Without Argument

Source: https://github.com/wendux/dsbridge-ios/blob/master/dsbridgedemo/test.html

Shows a synchronous call to 'testNoArgSyn' without passing any arguments.

```javascript
function callNoArgSyn() { alert(dsBridge.call("testNoArgSyn")); }
```

--------------------------------

### Register JavaScript Method (dsBridge)

Source: https://github.com/wendux/dsbridge-ios/blob/master/README.md

Registers a JavaScript method or namespace with the dsBridge. This allows native code to call these registered JavaScript functions.

```javascript
dsBridge.register(methodName|namespace,function|synApiObject)
```

--------------------------------

### Call JavaScript Method (dsBridge)

Source: https://github.com/wendux/dsbridge-ios/blob/master/README.md

Synchronously and asynchronously calls Java APIs using the dsBridge object. Arguments can be passed as a single JSON object if multiple parameters are needed. A callback handles the return value for asynchronous calls.

```javascript
dsBridge.call(method,[arg,callback])
```

--------------------------------

### Object-C Progress Callback

Source: https://github.com/wendux/dsbridge-ios/blob/master/readme-chs.md

Implements a progress callback mechanism in Object-C for scenarios requiring multiple return values from a single call, such as download progress. It uses NSTimer to repeatedly send progress updates.

```objective-c
- ( void )callProgress:(NSDictionary *) args :(JSCallback)completionHandler
{
    value=10;
    hanlder=completionHandler;
    timer =  [NSTimer scheduledTimerWithTimeInterval:1.0
                                              target:self
                                            selector:@selector(onTimer:)
                                            userInfo:nil
                                             repeats:YES];
}
-(void)onTimer:t{
    if(value!=-1){
        hanlder([NSNumber numberWithInt:value--],NO);
    }else{
        hanlder(@"",YES);
        [timer invalidate];
    }
}
```

--------------------------------

### Register Synchronous Method 'addValue'

Source: https://github.com/wendux/dsbridge-ios/blob/master/dsbridgedemo/test.html

Registers a synchronous JavaScript function 'addValue' that takes two arguments and returns their sum.

```javascript
dsBridge.register('addValue', function (r, l) { return r + l; })
```

--------------------------------

### Object-C Call JavaScript Handler

Source: https://github.com/wendux/dsbridge-ios/blob/master/readme-chs.md

Provides methods in Object-C to invoke JavaScript functions exposed through DSBridge. It supports calling handlers with or without arguments and includes options for receiving return values via a completion handler.

```objective-c
[dwebview callHandler:@"append" arguments:@[@"I",@"love",@"you"]
  completionHandler:^(NSString * _Nullable value) {
       NSLog(@"call succeed, append string is: %@",value);
}];
// call with namespace 'syn', More details to see the Demo project
[dwebview callHandler:@"syn.getInfo" completionHandler:^(NSDictionary * _Nullable value) {
        NSLog(@"Namespace syn.getInfo: %@",value);
}];
```

--------------------------------

### Call JavaScript API from Objective-C

Source: https://github.com/wendux/dsbridge-ios/blob/master/README.md

Illustrates how to invoke a JavaScript function that has been registered on the web view from the Objective-C native code. This allows for communication initiated from the native side to the JavaScript environment.

```Objective-C
[dwebview callHandler:@"addValue" arguments:@[@3,@4] completionHandler:^(NSNumber* value){
        NSLog(@"%@",value);
}];
```

--------------------------------

### Register Objective-C API with Namespace

Source: https://github.com/wendux/dsbridge-ios/blob/master/README.md

This Objective-C code registers a JavaScript API object with a specified namespace. JavaScript can then invoke these Objective-C methods using the format 'namespace.methodName'.

```objective-c
@implementation JsEchoApi
- (id) syn:(id) arg
{
    return arg;
}
- (void) asyn: (id) arg :(JSCallback)completionHandler
{
    completionHandler(arg,YES);
}
@end
// register api object with namespace "echo"
[dwebview addJavascriptObject:[[JsEchoApi alloc] init] namespace:@"echo"];
```

--------------------------------

### Call Progress Method

Source: https://github.com/wendux/dsbridge-ios/blob/master/dsbridgedemo/test.html

Calls a native method 'callProgress' and updates an HTML element with the ID 'progress' with the received value.

```javascript
function callProgress() { dsBridge.call("callProgress", function (value) { if(value==0) value=""; document.getElementById("progress").innerText = value }) }
```

--------------------------------

### Handle Progress Callback in JavaScript

Source: https://github.com/wendux/dsbridge-ios/blob/master/README.md

This JavaScript snippet shows how to receive and display progress updates from a native Objective-C function using DSBridge. It updates an HTML element with the received progress value.

```javascript
dsBridge.call("callProgress", function (value) {
    document.getElementById("progress").innerText = value
})
```

--------------------------------

### Register Asynchronous Method 'append'

Source: https://github.com/wendux/dsbridge-ios/blob/master/dsbridgedemo/test.html

Registers an asynchronous JavaScript function 'append' that takes three arguments and a callback, concatenating the arguments and passing the result to the callback.

```javascript
dsBridge.registerAsyn('append', function (arg1, arg2, arg3, responseCallback) { responseCallback(arg1 + " " + arg2 + " " + arg3); })
```

--------------------------------

### Enable DSBridge Debug Mode

Source: https://github.com/wendux/dsbridge-ios/blob/master/README.md

To enable debug mode in DSBridge for iOS, use the provided Objective-C method. Debug mode helps in identifying and resolving issues by displaying error popups and exceptions.

```objective-c
// open debug mode
[dwebview setDebugMode:true];
```

--------------------------------

### Declare Swift APIs with @objc

Source: https://github.com/wendux/dsbridge-ios/blob/master/README.md

In Swift, APIs intended for JavaScript interaction must be declared with the '@objc' attribute. This allows Objective-C runtime to access them. Use '_' to ignore the first argument name explicitly.

```swift
//MUST USE "_" to ignore the first argument name explicitly。
@objc func testSyn( _ arg:String) -> String {
	return String(format:"%@[Swift sync call:%@]", arg, "test")
}

@objc func testAsyn( _ arg:String, handler: (String, Bool)->Void) {
	handler(String(format:"%@[Swift async call:%@]", arg, "test"), true)
}
```

--------------------------------

### Call Native API (JavaScript to Objective-C)

Source: https://github.com/wendux/dsbridge-ios/blob/master/readme-chs.md

Synchronously or asynchronously calls a native Java API method. The method name can include a namespace. Arguments can be passed, and a callback handles the return value for asynchronous calls.

```JavaScript
dsBridge.call(method,[arg,callback])
```

--------------------------------

### Enable DSBridge Debug Mode

Source: https://github.com/wendux/dsbridge-ios/blob/master/readme-chs.md

Shows how to enable debug mode for DSBridge in Objective-C. When enabled, errors are displayed as pop-ups, and native API exceptions are not automatically caught, aiding in development.

```Objective-C
// open debug mode
[dwebview setDebugMode:true];
```

--------------------------------

### Check for Native Methods with DSBridge

Source: https://github.com/wendux/dsbridge-ios/blob/master/README.md

Determine if a native method is registered within DSBridge. The `handlerName` can include a namespace, and an optional `type` parameter can specify whether to check for 'all', 'syn' (synchronous), or 'asyn' (asynchronous) methods.

```javascript
dsBridge.hasNativeMethod('testAsyn') 
//test namespace method
dsBridge.hasNativeMethod('test.testAsyn')
// test if exist a asynchronous function that named "testSyn"
dsBridge.hasNativeMethod('testSyn','asyn') //false
```

--------------------------------

### Call JavaScript Methods from Objective-C

Source: https://github.com/wendux/dsbridge-ios/blob/master/README.md

Invoke registered JavaScript methods from Objective-C using the `callHandler` method. Arguments can be passed as an array, and a completion handler is provided to receive the result from the JavaScript execution.

```objective-c
// call javascript method
   [dwebview callHandler:@"addValue" arguments:@[@3,@4] completionHandler:^(NSNumber * value){
         NSLog(@"%@",value);
   }];

   [dwebview callHandler:@"append" arguments:@[@"I",@"love",@"you"] completionHandler:^(NSString * _Nullable value) {
        NSLog(@"call succeed, append string is: %@",value);
   }];
```

```objective-c
[dwebview callHandler:@"test.test1" completionHandler:^(NSString * _Nullable value) {
           NSLog(@"Namespace test.test1: %@",value);
   }];

   [dwebview callHandler:@"test1.test1" completionHandler:^(NSString * _Nullable value) {
           NSLog(@"Namespace test1.test1: %@",value);
   }];
```

--------------------------------

### Register JavaScript API with DSBridge

Source: https://github.com/wendux/dsbridge-ios/blob/master/README.md

Register synchronous and asynchronous JavaScript APIs for native invocation. APIs can be registered as individual methods or as objects with namespaces. Note that JavaScript does not support function overloading, so methods with the same name cannot be both synchronous and asynchronous.

```javascript
dsBridge.register('addValue',function(l,r){
        return l+r;
   })
   dsBridge.registerAsyn('append',function(arg1,arg2,arg3,responseCallback){
        responseCallback(arg1+" "+arg2+" "+arg3);
   })
```

```javascript
//namespace test for synchronous
   dsBridge.register("test",{
     tag:"test",
     test1:function(){
   	return this.tag+"1"
     },
     test2:function(){
   	return this.tag+"2"
     }
   })
     
   //namespace test1 for asynchronous calls  
   dsBridge.registerAsyn("test1",{
     tag:"test1",
     test1:function(responseCallback){
   	return responseCallback(this.tag+"1")
     },
     test2:function(responseCallback){
   	return responseCallback(this.tag+"2")
     }
   })
```

--------------------------------

### Objective-C Asynchronous API Signature

Source: https://github.com/wendux/dsbridge-ios/blob/master/readme-chs.md

Defines the required signature for asynchronous APIs in Objective-C. These APIs use a `JSCallback` block to return results to JavaScript. The block takes an `id` for the result and a `BOOL` indicating completion.

```Objective-C
` (void) handler:(id)arg :(void (^)( id result,BOOL complete))completionHandler）`

`JSCallback` 是一个block类型:

```objective-c
typedef void (^JSCallback)(NSString * _Nullable result,BOOL complete);
```
```

--------------------------------

### Objective-C Synchronous API Signature

Source: https://github.com/wendux/dsbridge-ios/blob/master/readme-chs.md

Defines the required signature for synchronous APIs in Objective-C. The handler must accept an `id` argument and return an `id` (cannot be void). If no argument is needed, it must still be declared.

```Objective-C
`(id) handler:(id) msg`
```

--------------------------------

### Stress Test Asynchronous Calls

Source: https://github.com/wendux/dsbridge-ios/blob/master/dsbridgedemo/test.html

Performs 2000 consecutive asynchronous API calls to 'testAsyn' and alerts the user when all tasks are completed.

```javascript
function callAsyn_() { for (var i = 0; i < 2000; i++) { dsBridge.call("testAsyn", "js+" + i, function (v) { if (v == "js+1999 [ asyn call]") { alert("All tasks completed!") } }) } }
```

--------------------------------

### Call JavaScript Object Method (Objective-C)

Source: https://github.com/wendux/dsbridge-ios/blob/master/readme-chs.md

Calls methods within a registered JavaScript object, using dot notation for namespaces. The completion handler processes the returned value.

```Objective-C
[dwebview callHandler:@"test.test1" completionHandler:^(NSString * _Nullable value) {
        NSLog(@"Namespace test.test1: %@",value);
}];

[dwebview callHandler:@"test1.test1" completionHandler:^(NSString * _Nullable value) {
        NSLog(@"Namespace test1.test1: %@",value);
}];
```

--------------------------------

### Check JavaScript Method Existence

Source: https://github.com/wendux/dsbridge-ios/blob/master/README.md

Tests if a specified JavaScript method exists within the bridge. A callback is provided to receive the boolean result indicating whether the method exists.

```objective-c
// test if javascript method exists.
[dwebview hasJavascriptMethod:@"addValue" methodExistCallback:^(bool exist) {
      NSLog(@"method 'addValue' exist : %d",exist);
}];
```

--------------------------------

### Call Native API (Objective-C to JavaScript)

Source: https://github.com/wendux/dsbridge-ios/blob/master/readme-chs.md

Invokes a JavaScript method from Objective-C. Arguments are passed as an array, and a completion handler processes the result.

```Objective-C
// call javascript method
[dwebview callHandler:@"addValue" arguments:@[@3,@4] completionHandler:^(NSNumber * value){
      NSLog(@"%@",value);
}];

[dwebview callHandler:@"append" arguments:@[@"I",@"love",@"you"] completionHandler:^(NSString * _Nullable value) {
     NSLog(@"call succeed, append string is: %@",value);
}];
```

--------------------------------

### Object-C Check JavaScript Method Existence

Source: https://github.com/wendux/dsbridge-ios/blob/master/readme-chs.md

Checks for the existence of a specific JavaScript API method in Object-C. It takes a handler name (which can include a namespace) and provides a callback with a boolean indicating whether the method exists.

```objective-c
// test if javascript method exists.
[dwebview hasJavascriptMethod:@"addValue" methodExistCallback:^(bool exist) {
      NSLog(@"method 'addValue' exist : %d",exist);
}];
```

--------------------------------

### Customize JavaScript Dialog Labels

Source: https://github.com/wendux/dsbridge-ios/blob/master/README.md

Allows customization of the text labels for JavaScript alert, confirm, and prompt dialogs. This enables localization or branding of these UI elements.

```objective-c
[dwebview customJavascriptDialogLabelTitles:@{
 @"alertTitle":@"Notification",
 @"alertBtn":@"OK",
 @"confirmTitle":@"",
 @"confirmCancelBtn":@"CANCEL",
 @"confirmOkBtn":@"OK",
 @"promptCancelBtn":@"CANCEL",
 @"promptOkBtn":@"OK"
}];
```

--------------------------------

### Set JavaScript Close Window Listener

Source: https://github.com/wendux/dsbridge-ios/blob/master/README.md

Registers a callback block that is executed when JavaScript calls `window.close()`. This allows custom handling of window close events initiated from the JavaScript side.

```objective-c
[dwebview setJavascriptCloseWindowListener:^{ 
        NSLog(@"window.close called");
}];
```

--------------------------------

### Check for Native Method (JavaScript)

Source: https://github.com/wendux/dsbridge-ios/blob/master/readme-chs.md

Checks if a native API method with a given name exists in the Java side. The handler name can include a namespace, and an optional type parameter can specify 'all', 'syn', or 'asyn'.

```JavaScript
//检测是否存在一个名为'testAsyn'的API(无论同步还是异步)
dsBridge.hasNativeMethod('testAsyn') 
//检测test命名空间下是否存在一个’testAsyn’的API
dsBridge.hasNativeMethod('test.testAsyn')
// 检测是否存在一个名为"testSyn"的异步API
dsBridge.hasNativeMethod('testSyn','asyn') //false
```

--------------------------------

### JavaScript Progress Display

Source: https://github.com/wendux/dsbridge-ios/blob/master/readme-chs.md

Displays progress updates received from the native side in a JavaScript environment. It listens for progress values and updates an HTML element with the current progress.

```javascript
dsBridge.call("callProgress", function (value) {
	document.getElementById("progress").innerText = value
})
```

--------------------------------

### Object-C Add JavaScript Object

Source: https://github.com/wendux/dsbridge-ios/blob/master/readme-chs.md

Adds an Object-C API object to a DWKWebView, enabling it to be called from JavaScript with a specified namespace. If no namespace is provided, the object can be called directly.

```objective-c
@implementation JsEchoApi
- (id) syn:(id) arg
{
    return arg;
}
- (void) asyn: (id) arg :(JSCallback)completionHandler
{
    completionHandler(arg,YES);
}
@end
// register api object with namespace "echo"
[dwebview addJavascriptObject:[[JsEchoApi alloc] init] namespace:@"echo"];
```

--------------------------------

### Customize Javascript Dialog Labels (Objective-C)

Source: https://github.com/wendux/dsbridge-ios/blob/master/readme-chs.md

Allows customization of label texts for JavaScript dialogs (alert, confirm, prompt). The default language is Chinese, but custom English labels can be provided.

```Objective-C
[dwebview customJavascriptDialogLabelTitles:@{
 @"alertTitle":@"Notification",
 @"alertBtn":@"OK",
 @"confirmTitle":@"",
 @"confirmCancelBtn":@"CANCEL",
 @"confirmOkBtn":@"OK",
 @"promptCancelBtn":@"CANCEL",
 @"promptOkBtn":@"OK"
}];
```

--------------------------------

### Object-C Set JavaScript Close Window Listener

Source: https://github.com/wendux/dsbridge-ios/blob/master/readme-chs.md

Sets a callback listener in Object-C that is triggered when JavaScript calls `window.close`. This allows for custom handling of window closing events initiated from the web view.

```objective-c
[dwebview setJavascriptCloseWindowListener:^{ 
        NSLog(@"window.close called"); 
}];
```

--------------------------------

### Register JavaScript Method (JavaScript)

Source: https://github.com/wendux/dsbridge-ios/blob/master/readme-chs.md

Registers a synchronous or asynchronous JavaScript API method. This can be a standalone function or part of an object with a namespace.

```JavaScript
dsBridge.register('addValue',function(l,r){
     return l+r;
})
dsBridge.registerAsyn('append',function(arg1,arg2,arg3,responseCallback){
     responseCallback(arg1+" "+arg2+" "+arg3);
})
```

--------------------------------

### Check Native Method Existence

Source: https://github.com/wendux/dsbridge-ios/blob/master/dsbridgedemo/test.html

Checks if a native method with the given name exists using 'dsBridge.hasNativeMethod' and displays the boolean result.

```javascript
function hasNativeMethod(name) { alert(dsBridge.hasNativeMethod(name)) }
```

--------------------------------

### Register JavaScript Object with Namespace (JavaScript)

Source: https://github.com/wendux/dsbridge-ios/blob/master/readme-chs.md

Registers a JavaScript object with a specified namespace for synchronous or asynchronous calls. Note that the same JavaScript object cannot define synchronous and asynchronous functions with the same name.

```JavaScript
//namespace test for synchronous
dsBridge.register("test",{
  tag:"test",
  test1:function(){
	return this.tag+"1"
  },
  test2:function(){
	return this.tag+"2"
  }
})
  
//namespace test1 for asynchronous calls  
dsBridge.registerAsyn("test1",{
  tag:"test1",
  test1:function(responseCallback){
	return responseCallback(this.tag+"1")
  },
  test2:function(responseCallback){
	return responseCallback(this.tag+"2")
  }
})
```

--------------------------------

### Set Debug Mode

Source: https://github.com/wendux/dsbridge-ios/blob/master/README.md

Enables or disables debug mode. In debug mode, errors are prompted via dialogs, and native API exceptions are not captured, which is recommended during development.

```objective-c
[dwebview setDebugMode:(true)]
```

--------------------------------

### Object-C Set Debug Mode

Source: https://github.com/wendux/dsbridge-ios/blob/master/readme-chs.md

Configures the debug mode for DSBridge in Object-C. When enabled, errors are shown in pop-ups, and uncaught exceptions in native APIs are not suppressed, aiding in development and debugging.

```objective-c
[dwebview setDebugMode: true]
```

--------------------------------

### Disable/Enable Javascript Dialog Block (JavaScript)

Source: https://github.com/wendux/dsbridge-ios/blob/master/readme-chs.md

Controls the blocking of JavaScript dialogs. Calling `dsBridge.disableJavascriptDialogBlock()` with no arguments disables blocking, while calling it with `false` enables it.

```JavaScript
//disable
dsBridge.disableJavascriptDialogBlock()
//enable
dsBridge.disableJavascriptDialogBlock(false)
```

--------------------------------

### Disable JavaScript Dialog Blocking

Source: https://github.com/wendux/dsbridge-ios/blob/master/README.md

Controls whether JavaScript's alert, confirm, and prompt dialogs block the execution flow. When disabled, these functions return immediately without blocking.

```objective-c
[dwebview disableJavascriptDialogBlock: true]
```

--------------------------------

### Disable/Enable JavaScript Dialog Blocking

Source: https://github.com/wendux/dsbridge-ios/blob/master/README.md

Control the blocking behavior of JavaScript dialogs. Calling `dsBridge.disableJavascriptDialogBlock()` without arguments or with `true` disables the blocking, while calling it with `false` enables it.

```javascript
//disable
dsBridge.disableJavascriptDialogBlock()
//enable
dsBridge.disableJavascriptDialogBlock(false)
```

--------------------------------

### Object-C Disable JavaScript Dialog Block

Source: https://github.com/wendux/dsbridge-ios/blob/master/readme-chs.md

Allows disabling the blocking behavior of JavaScript dialogs (alert, confirm, prompt) in Object-C. When disabled, these dialogs appear non-modally, preventing the UI thread from freezing.

```objective-c
[dwebview disableJavascriptDialogBlock: true]
```
Tokens:
Raw