WebApi API

To use Samsung Product API,

<script type="text/javascript" src="$WEBAPIS/webapis/webapis.js"></script>

Should be loaded in index.html

The module defines the functionalities that are provides as the Samsung TV for Tizen Platform Product API.
Additionally, this API specifies the location in the ECMAScript hierarchy in which the Samsung TV for Tizen Platform Product API is instantiated (window.webapis).

Since : 2.3

Product : TV, AV, B2B

Summary of Interfaces and Methods

1. Interfaces

1.1 WebApiObject

This interface defines the webapis interface as a part of the window global object.

[NoInterfaceObject] interface WebApiObject {
  readonly attribute WebApi webapis;
};

Window implements WebApiObject;

Attributes

• readonly WebApi webapis
  Namespace for webapis.

1.2 WebApi

This interface defines the root of Tizen Samsung Product API.

[NoInterfaceObject] interface WebApi {
};

1.3 WebAPIException

This interface defines Exception errors of APIs.

[NoInterfaceObject] interface WebAPIException {
  const unsigned long INDEX_SIZE_ERR = 1;
  const unsigned long DOMSTRING_SIZE_ERR = 2;
  const unsigned long HIERARCHY_REQUEST_ERR = 3;
  const unsigned long WRONG_DOCUMENT_ERR = 4;
  const unsigned long INVALID_CHARACTER_ERR = 5;
  const unsigned long NO_DATA_ALLOWED_ERR = 6;
  const unsigned long NO_MODIFICATION_ALLOWED_ERR = 7;
  const unsigned long NOT_FOUND_ERR = 8;
  const unsigned long NOT_SUPPORTED_ERR = 9;
  const unsigned long INUSE_ATTRIBUTE_ERR = 10;
  const unsigned long INVALID_STATE_ERR = 11;
  const unsigned long SYNTAX_ERR = 12;
  const unsigned long INVALID_MODIFICATION_ERR = 13;
  const unsigned long NAMESPACE_ERR = 14;
  const unsigned long INVALID_ACCESS_ERR = 15;
  const unsigned long VALIDATION_ERR = 16;
  const unsigned long TYPE_MISMATCH_ERR = 17;
  const unsigned long SECURITY_ERR = 18;
  const unsigned long NETWORK_ERR = 19;
  const unsigned long ABORT_ERR = 20;
  const unsigned long URL_MISMATCH_ERR = 21;
  const unsigned long QUOTA_EXCEEDED_ERR = 22;
  const unsigned long TIMEOUT_ERR = 23;
  const unsigned long INVALID_NODE_TYPE_ERR = 24;
  const unsigned long DATA_CLONE_ERR = 25;
  const unsigned long INVALID_VALUES_ERR = 26;
  const unsigned long IO_ERR = 27;
  const unsigned long SERVICE_NOT_AVAILABLE_ERR = 28;
  const unsigned long UNKNOWN_ERR = 9999;

  readonly attribute unsigned long code;
  readonly attribute DOMString name;
  readonly attribute DOMString message;
};

Constants

• INDEX_SIZE_ERR
  The index is not in the allowed range.
• DOMSTRING_SIZE_ERR
  The specified range of text is too large.
• HIERARCHY_REQUEST_ERR
  The operation would yield an incorrect node tree.
• WRONG_DOCUMENT_ERR
  The object is in the wrong document.
• INVALID_CHARACTER_ERR
  The string contains invalid characters.
• NO_DATA_ALLOWED_ERR
  Data is specified for a node that does not support data.
• NO_MODIFICATION_ALLOWED_ERR
  The object cannot be modified.
• NOT_FOUND_ERR
  The object cannot be found here.
• NOT_SUPPORTED_ERR
  The operation is not supported.
• INUSE_ATTRIBUTE_ERR
  The specified attribute is already in use elsewhere.
• INVALID_STATE_ERR
  The object is in an invalid state.
• SYNTAX_ERR
  The string did not match the expected pattern.
• INVALID_MODIFICATION_ERR
  The object cannot be modified in this way.
• NAMESPACE_ERR
  The operation is not allowed by Namespaces in XML.
• INVALID_ACCESS_ERR
  The object does not support the operation or argument.
• VALIDATION_ERR
  The operation would cause the node to fail validation.
• TYPE_MISMATCH_ERR
  The type of the object does not match the expected type.
• SECURITY_ERR
  The operation is insecure.
• NETWORK_ERR
  A network error occurred.
• ABORT_ERR
  The operation has been aborted.
• URL_MISMATCH_ERR
  The given URL does not match another URL.
• QUOTA_EXCEEDED_ERR
  The quota has been exceeded.
• TIMEOUT_ERR
  The operation has timed out.
• INVALID_NODE_TYPE_ERR
  The supplied node is incorrect or has an incorrect ancestor for this operation.
• DATA_CLONE_ERR
  The object cannot be cloned.
• INVALID_VALUES_ERR
  Input parameters contain an invalid value
• IO_ERR
  IOs have error.
• SERVICE_NOT_AVAILABLE_ERR
  Service is not available error.
• UNKNOWN_ERR
  This means an unknown error.

Attributes

• readonly unsigned long code
  An error code value
• readonly DOMString name
  An error type name. The name attribute must return the value it had been initialized with.
• readonly DOMString message
  An error message that describes the details of an encountered error.

1.4 WebAPIError

This interface will be used by the APIs in order to return them in the error callback of asynchronous methods.

[NoInterfaceObject] interface WebAPIError {
  readonly attribute unsigned long code;
  readonly attribute DOMString name;
  readonly attribute DOMString message;
};

Attributes

• readonly unsigned long code
  An error code value
• readonly DOMString name
  An error type name. The name attribute must return the value it had been initialized with.
• readonly DOMString message
  An error message that describes the details of an encountered error.

1.5 SuccessCallback

This interface is used in methods that do not require any return value in the success callback.

[Callback = FunctionOnly, NoInterfaceObject] interface SuccessCallback {
  void onsuccess();
};

Methods

onsuccess

void onsuccess();

function onsuccess()
{
  console.log("Success Callback is called.");
}

1.6 ErrorCallback

This interface is used in methods that require only an error as an input parameter in the error callback.

[Callback = FunctionOnly, NoInterfaceObject] interface ErrorCallback {
  void onerror(WebAPIError error);
};

Methods

onerror

void onerror(WebAPIError error);

function onerror(error)
{
  console.log(error.message);
}

2. Full WebIDL

module WebApi {
  [NoInterfaceObject] interface WebApiObject {
    readonly attribute WebApi webapis;
  };

  Window implements WebApiObject;

  [NoInterfaceObject] interface WebApi {
  };

  [NoInterfaceObject] interface WebAPIException {
    const unsigned long INDEX_SIZE_ERR = 1;
    const unsigned long DOMSTRING_SIZE_ERR = 2;
    const unsigned long HIERARCHY_REQUEST_ERR = 3;
    const unsigned long WRONG_DOCUMENT_ERR = 4;
    const unsigned long INVALID_CHARACTER_ERR = 5;
    const unsigned long NO_DATA_ALLOWED_ERR = 6;
    const unsigned long NO_MODIFICATION_ALLOWED_ERR = 7;
    const unsigned long NOT_FOUND_ERR = 8;
    const unsigned long NOT_SUPPORTED_ERR = 9;
    const unsigned long INUSE_ATTRIBUTE_ERR = 10;
    const unsigned long INVALID_STATE_ERR = 11;
    const unsigned long SYNTAX_ERR = 12;
    const unsigned long INVALID_MODIFICATION_ERR = 13;
    const unsigned long NAMESPACE_ERR = 14;
    const unsigned long INVALID_ACCESS_ERR = 15;
    const unsigned long VALIDATION_ERR = 16;
    const unsigned long TYPE_MISMATCH_ERR = 17;
    const unsigned long SECURITY_ERR = 18;
    const unsigned long NETWORK_ERR = 19;
    const unsigned long ABORT_ERR = 20;
    const unsigned long URL_MISMATCH_ERR = 21;
    const unsigned long QUOTA_EXCEEDED_ERR = 22;
    const unsigned long TIMEOUT_ERR = 23;
    const unsigned long INVALID_NODE_TYPE_ERR = 24;
    const unsigned long DATA_CLONE_ERR = 25;
    const unsigned long INVALID_VALUES_ERR = 26;
    const unsigned long IO_ERR = 27;
    const unsigned long SERVICE_NOT_AVAILABLE_ERR = 28;
    const unsigned long UNKNOWN_ERR = 9999;
  
    readonly attribute unsigned long code;
    readonly attribute DOMString name;
    readonly attribute DOMString message;
  };

  [NoInterfaceObject] interface WebAPIError {
    readonly attribute unsigned long code;
    readonly attribute DOMString name;
    readonly attribute DOMString message;
  };

  [Callback = FunctionOnly, NoInterfaceObject] interface SuccessCallback {
    void onsuccess();
  };

  [Callback = FunctionOnly, NoInterfaceObject] interface ErrorCallback {
    void onerror(WebAPIError error);
  };

};