Marionette JS Client

API Docs for: 1.7.1
Show:

Marionette.Drivers.MozTcp Class

Connects to gecko marionette server using mozTCP api.

// default options are fine for b2g-desktop
// or a device device /w port forwarding.
var tcp = new Marionette.Drivers.MozTcp();

tcp.connect(function() {
  // ready to use with client
});

Constructor

Marionette.Drivers.MozTcp

(
  • options
)

Parameters:

  • options Object

    connection options.

    • [host="127.0.0.1"] String optional

      ip/host.

    • [port="2828"] Numeric optional

      marionette server port.

Methods

_nextCommand

() private

Checks queue if not waiting for a response Sends command to websocket server

_onDeviceResponse

(
  • data
)
private

Handles responses from devices. Will only respond to the event if the connectionId is equal to the event id and the client is ready.

Parameters:

  • data Object

    response from server.

close

()

Destroys connection to server

Will immediately close connection to server closing any pending responses.

connect

(
  • callback
)

Connects to a remote server. Requires a _connect function to be defined.

MyClass.prototype._connect = function _connect(){
  //open a socket to marrionete accept response
  //you *must* call _onDeviceResponse with the first
  //response from marionette it looks like this:
  //{ from: 'root', applicationType: 'gecko', traits: [] }
  this.connectionId = result.id;
}

Parameters:

  • callback Function

    executes after successfully connecting to the server.

send

(
  • command
  • callback
)

Sends remote command to server. Each command will be queued while waiting for any pending commands. This ensures order of response is correct.

Parameters:

  • command Object

    remote command to send to marionette.

  • callback Function

    executed when response comes back.

setScriptTiemout

(
  • the
)

We just set the script timeout. If you need to do something in the driver.

Parameters:

  • the Integer

    timeout value.

Properties

_waiting

Boolean private

Waiting for a command to finish?

connectionId

Numeric

Connection id for the server.

ready

Boolean

Is system ready for commands?

timeout

Numeric

Timeout for commands