Methods

setUserAgentString

Sets the custom user agent string for your Web application.

void setUserAgentString(DOMString userAgent, optional SuccessCallback? successCallback, optional ErrorCallback? errorCallback);
             

Since: 2.4

This method allows the user to set the user agent string of the Web view in the Web application. By default, the Web view in your application has the same user agent string as the Tizen browser on the device.

The ErrorCallback is launched with these error types:

• UnknownError - If any error occurs while setting the user agent string.
• InvalidValuesError - If any of the input parameters contain an invalid value.

Parameters:

• userAgent: User agent to set for the Web view in your Web application.
• successCallback [optional] [nullable]: To be invoked if the requested setting operation succeeds.
• errorCallback [optional] [nullable]: To be invoked if the requested setting operation fails.

Exceptions:

• WebAPIException

  • with error type TypeMismatchError, if any input parameter is not compatible with the expected type for that parameter.

Code example:

 function successCallback() {
     console.log("The requested user agent string has just been set successfully.");
 }

 tizen.websetting.setUserAgentString("the new user agent string to set", successCallback);
 

removeAllCookies

Removes all the cookies saved for the Web view in your Web application.

void removeAllCookies(optional SuccessCallback? successCallback, optional ErrorCallback? errorCallback);
             

Since: 2.4

The Web view in your Web application can store cookies like a browser. This method allows the user to remove all the cookies saved for the Web application.

The ErrorCallback is launched with these error types:

• UnknownError - If any error occurs while deleting the cookies.

Warning: http://tizen.org/privilege/websetting(public level privilege) MUST NOT be declared to use this API since 2.4.

Parameters:

• successCallback [optional] [nullable]: To be invoked if the requested delete operation succeeds.
• errorCallback [optional] [nullable]: To be invoked if the requested delete operation fails.

Exceptions:

• WebAPIException

  • with error type TypeMismatchError, if any input parameter is not compatible with the expected type for that parameter.

Code example:

 function successCallback() {
     console.log("The cookies saved for your application have just been removed.");
 }

 tizen.websetting.removeAllCookies(successCallback);