mozilla
Your Search Results

    nsIXPCException

    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, Nickolay, trevorh, sdwilsh, Varmaa, Phreed, Wladimir_Palant
    Last updated by: Sheppy,