@precor/web-api-bridge
Provides api marshalling for React Native WebvViews and web page iframes.
Last updated 5 months ago by robseaman .
MIT · Repository · Original npm · Tarball · package.json
$ cnpm install @precor/web-api-bridge 
SYNC missed versions from official npm registry.

WebApiBridge

WebApiBridge provides a function call API interface between Javascript processes that pass MessageEvent objects such as a a web page and an iframe or a React Native application and a web app running in a react-native-webview.

Features

  • Provides support for API calls between JavaScript processes. Each process can support API calls in an array of JavaScript objects (inluding React components)
  • Marshalls plain JavaScript parameters and return values via JSON.stringify() to work with react-native-community/react-native-webview, including support of ReactNativeWebView.postMessage
  • Works for communication between a web page and iframe child window
  • Provides promise support for asynchronous API calls that need to return results
  • Marshalls exceptions thown in API calls to the caller
  • Validates the existance of API call and message delivery so reliability errors are reported
  • Supports origin and targetOrigin settings
  • A listener() function hook is provided for debugging that will be passed all messages sent/received

Installation

If you're using npm:

npm install --save @precor/web-api-bridge

or, if you're using yarn:

yarn add @precor/web-api-bridge

Type Checking

a Typescript definition file is included. The Proptype declaration for Message is included in types/shapes.js, i.e. to use it:

import { Message } from '@precor/web-api-bridge/types/shapes';

Documentation

WebApiBridge Class

Examples

react-iframe is a simple react implementation of an API between a parent and an iframe.

react-multi is a react implementation of an API between a parent and multiple iframes.

webapp-library extends the react-multi example by creating a functional library abstraction over the bridge for the web app iframes. It also demonstrates mulitiple apis per window and dynamic additions of apis after the iframe based web apps are loaded.

Gotchas

  • If you need to send a message from an app that loads a webview or an iframe, e.g. from a React Native app or a window parent, before receiving from that app then wait for the load to complete, e.g. onLoad callback to send that initial message.

Current Tags

  • 2.1.5                                ...           latest (5 months ago)

12 Versions

  • 2.1.5                                ...           5 months ago
  • 2.1.4                                ...           5 months ago
  • 2.1.3                                ...           5 months ago
  • 2.1.2                                ...           5 months ago
  • 2.1.1                                ...           a year ago
  • 2.1.0                                ...           a year ago
  • 2.0.0                                ...           a year ago
  • 1.0.0                                ...           a year ago
  • 0.0.4                                ...           a year ago
  • 0.0.3                                ...           a year ago
  • 0.0.2                                ...           2 years ago
  • 0.0.1                                ...           2 years ago
Maintainers (2)
Downloads
Today 0
This Week 0
This Month 0
Last Day 0
Last Week 0
Last Month 0
Dependencies (1)
Dev Dependencies (13)
Dependents (1)

Copyright 2014 - 2016 © taobao.org |