Please note, this is a STATIC archive of website developer.mozilla.org from November 2016, cach3.com does not collect or store any user information, there is no "phishing" involved.

These exception objects are the preferred types of exceptions when implementing xpcom interfaces in JavaScript.
Inherits from: nsIException Last changed in Gecko 1.9.2 (Firefox 3.6 / Thunderbird 3.1 / Fennec 1.0)

Method overview

void initialize(in string aMessage, in nsresult aResult, in string aName, in nsIStackFrame aLocation, in nsISupports aData, in nsIException aInner);
xpcexJSVal stealJSVal(); Native code only!
void stowJSVal(in xpcexJSContextPtr cx, in xpcexJSVal val); Native code only!

Methods

initialize()

void initialize(
  in string aMessage,
  in nsresult aResult,
  in string aName,
  in nsIStackFrame aLocation,
  in nsISupports aData,
  in nsIException aInner
);
Parameters
aMessage
aResult
aName
aLocation
aData
aInner

Native code only!

stealJSVal

xpcexJSVal stealJSVal();
Parameters

None.

Return value

 

Native code only!

stowJSVal

void stowJSVal(
  in xpcexJSContextPtr cx,
  in xpcexJSVal val
);
Parameters
cx
val

Remarks

Components.Exception is a JavaScript constructor to create nsIXPCException objects. The call signature of the constructor is:

Components.Exception(message, result, stack, data, inner)

all parameters are optional and the appropriate placeholder is 'unknown'.

  • message - A custom message set by the thrower (defaults to 'exception')
  • result - The nsresult associated with this exception (defaults to Components.results.NS_ERROR_FAILURE)
  • stack - The stack chain (defaults to the current stack)
  • data - additional data object of your choice (defaults to null)
  • inner - An inner exception that triggered this, if available

Document Tags and Contributors

 Contributors to this page: Sheppy, trevorh, Varmaa, Wladimir_Palant, sdwilsh, Nickolay, Phreed
 Last updated by: Sheppy,