ForceJS

ForceJS is a micro-library that makes it easy to use the Salesforce REST APIs in JavaScript applications. ForceJS allows you to easily login into Salesforce using OAuth, and to manipulate your Salesforce data using a simple API.

ForceJS is similar to ForceTK, but has no jQuery dependency and comes with an AngularJS version (ForceNG).

The main target for ForceJS are applications running on your own server (Heroku or elsewhere), or locally on a mobile device and accessing Salesforce through REST services. If your application is hosted inside Salesforce (in a Visualforce page), consider using Visualforce Remoting or Remote Objects to access your Salesforce data.

This is an early version. I appreciate any feedback, comments, and help if you think this library is useful.

Key Characteristics

No jQuery dependency
Plain JavaScript (ForceJS) and Angular Service (ForceNG) versions
Complete OAuth login workflow
Works transparently in the browser and in Cordova using the In-App browser plugin or the Salesforce Mobile SDK plugin for OAuth (coming soon)
Automatically refreshes OAuth access_token on expiration
Simple API to manipulate data (create, update, delete, upsert)
Node.js or Play/Scala proxies with CORS support available separately
Includes simple Bootstrap sample app

Usage

Initialize:
```
force.init({
    appId: 'SALESFORCE_CONNECTED_APP_CLIENT_ID',
    proxyURL: 'https://simple-cors-proxy.herokuapp.com'
});
```
Create a Connected Application in Salesforce to get a client id. Make sure you specify the right path to oauthcallback.html as the Callback URL. Read these instructions (step1 only) if you don't know how to create a Connected App.

force.login(
    function() {
        console.log('Login succeeded');
    },
    function(error) {
        alert('Login failed: ' + error);
    });

Invoke a function: query(), create(), update(), delete(), upsert(), or the generic request():

force.query('select id, firstName, lastName from contact',
    function(response) {
        console.log(response);
    },
    function(error) {
        console.log(error);
    });

AngularJS version

An AngularJS version (ForceNG) implemented as a service and using promises instead of callback functions is available here.

Proxy Server

Because of the browser's cross-origin restrictions, your JavaScript application hosted on your own server (or localhost) will not be able to make API calls directly to the *.salesforce.com domain. The solution is to proxy your API calls through your own server. ForceJS has been tested with two proxy servers:

cors-proxy: A node.js implementation
sf-cors-proxy: A Scala / Play implementation by James Ward

You can use ForceJS with your own proxy server as well.

Other Libraries