mozilla
Your Search Results

    MozActivity

    Non-standard
    This feature is not on a current W3C standards track, but it is supported on the Firefox OS platform. Although implementations may change in the future and it is not supported widely across browsers, it is suitable for use in code dedicated to Firefox OS apps.

    This API is available on Firefox or Firefox OS for installed or higher privileged applications.

    This API is available to installed code running on Firefox for Android, and is intended for use by Firefox for Android Webapps in Firefox for Android 32+.

    Summary

    The MozActivity interface allows apps to delegate an activity to another app.

    This interface fully inherits from the DOMRequest interface except that it has a constructor that it takes a MozActivityOptions as a parameter.

    Note: As soon as a MozActivity is instantiated, the system will prompt the user to choose an activity handler. It's not possible to instantiate an activity and wait to use it.

    Constructor

    new MozActivity( options )
    options
    An object that has the same properties as the ones define in the MozActivityOptions interface.

    Properties

    Inherited from DOMRequest:

    DOMRequest.onsuccess
    A callback handler called when the operation represented by the DOMRequest is completed.
    DOMRequest.onerror
    A callback handler that gets called when an error occurs while processing the operation.
    DOMRequest.readyState
    A string indicating whether or not the operation is finished running. Its value is either "done" or "pending".
    DOMRequest.result
    The operation's result.
    DOMRequest.error
    Error information, if any.

    Methods

    None.

    Example

    var activity = new MozActivity({
      // The name of the activity the app wants to delegate the action
      name: "pick",
    
      // Data required by the activity. Each application acting as an activity handler 
      // can have it's own requirement for the activity. If the data does not fulfill
      // all the requirement of any activity handler, the error event will be sent
      // otherwise, the event sent depend on the activity handler itself.
      data: {
        type: "image/jpeg"
      }
    });
    
    activity.onsuccess = function() {
      console.log("Activity successfuly handled");
    
      var imgSrc = this.result.blob;
    }
    
    activity.onerror = function() {
      console.log("The activity encouter en error: " + this.error);
    }
    

    Specification

    Web Activities is not part of any specification. However, it has some overlap with the proposed Web Intents specification. Mozilla actually proposed Web Activities as a counter proposal to Web Intents. For more information about this, see discussion on the Web Intents Task Force ML.

    See also

    Browser compatibility

    Firefox (Gecko)
    Not supported
    Firefox OS Firefox Mobile (Gecko)
    (Yes) 32.0 (32.0) (WebRT only)

     

    Document Tags and Contributors

    Last updated by: fscholz,