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
Interface | Method |
---|---|
WebApiObject | |
WebApi | |
WebAPIException | |
WebAPIError | |
SuccessCallback | void onsuccess(); |
ErrorCallback | void onerror(WebAPIError error); |
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
Method invoked when the asynchronous call completes successfully.
void onsuccess();
Product : TV, AV, B2B
Since : 2.3
Code Example :
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
Method that is invoked when an error occurs.
void onerror(WebAPIError error);
Product : TV, AV, B2B
Parameters :
- error : Generic error
Since : 2.3
Code Example :
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);
};
};