W3C APIs

Tabris implements a subset of popular W3C standards. Besides providing web developers with familiar APIs, this also enables you to use libraries developed for a browser environment.

window object

In JavaScript there is always an object that represents the global scope. All global variables are members of this object. As in a web browser, this object is named window in Tabris.js. For example, the tabris object can be accessed either via tabris or window.tabris.

console object

As in the browser, messages can be logged to the developer console using the global console object:

XMLHttpRequest

Only asynchronous requests are supported. Attempting a synchronous request will cause an error.

When a relative URL is given, Tabris.js will interpret it as a path relative to the application’s package.json. This allows you to read static resources (files residing in your project folder).

When using a custom built developer client, a relative URL may be used to access local files (bundled with the client as a resource) as well as those residing in the remote project folder (from which the code is loaded via HTTP). Local files take precedence.

To enable access to SSL protected resources that use self signed certificates, use the UseStrictSSL preference in the config.xml. See the Cordova documentation.

Fetch

As a more powerful and flexible alternative to XHR, you can also use the Fetch API.
As of Tabris.js 1.7, an implementation of this API is included.

To load static resources, working with URLs relative to the current module may be more convenient. In the case of a JSON file, this can be done simply by using the require method instead of XHR. For other types of files, use the __dirname variable, e.g. xhr.open("GET", __dirname + "/foo.txt");.

WebSocket

WebSockets are an advanced technology that makes it possible to open an interactive communication session between the user’s client and a server. With this API, you can send messages to a server and receive event-driven responses without having to poll the server for a reply.

As of Tabris.js 1.10, an implementation of this API is included.

The Tabris.js implementation supports to send and receive text messages as well as binary data in the form of TypedArray and ArrayBuffer. We currently do not support to receive data as Blob.

Further documentation:

https://tools.ietf.org/html/rfc6455

https://html.spec.whatwg.org/multipage/comms.html#websocket

Persistent Storage

Tabris supports the global object localStorage, which allows storing key-value pairs in a persistent store. Both keys and values are stored as strings.

On iOS, there is an additional object secureStorage available in the global scope. This is a drop-in replacement for localStorage that keeps data in the encrypted iOS Keychain.