Return to jsexn.h CVS log

Up to [Synchronet] / sbbs / include / mozilla / js

Annotation of sbbs/include/mozilla/js/jsexn.h, revision 1.1

1.1     ! root        1: /* -*- Mode: C; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 4 -*-
        !             2:  *
        !             3:  * ***** BEGIN LICENSE BLOCK *****
        !             4:  * Version: MPL 1.1/GPL 2.0/LGPL 2.1
        !             5:  *
        !             6:  * The contents of this file are subject to the Mozilla Public License Version
        !             7:  * 1.1 (the "License"); you may not use this file except in compliance with
        !             8:  * the License. You may obtain a copy of the License at
        !             9:  * http://www.mozilla.org/MPL/
        !            10:  *
        !            11:  * Software distributed under the License is distributed on an "AS IS" basis,
        !            12:  * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
        !            13:  * for the specific language governing rights and limitations under the
        !            14:  * License.
        !            15:  *
        !            16:  * The Original Code is Mozilla Communicator client code, released
        !            17:  * March 31, 1998.
        !            18:  *
        !            19:  * The Initial Developer of the Original Code is
        !            20:  * Netscape Communications Corporation.
        !            21:  * Portions created by the Initial Developer are Copyright (C) 1998
        !            22:  * the Initial Developer. All Rights Reserved.
        !            23:  *
        !            24:  * Contributor(s):
        !            25:  *
        !            26:  * Alternatively, the contents of this file may be used under the terms of
        !            27:  * either of the GNU General Public License Version 2 or later (the "GPL"),
        !            28:  * or the GNU Lesser General Public License Version 2.1 or later (the "LGPL"),
        !            29:  * in which case the provisions of the GPL or the LGPL are applicable instead
        !            30:  * of those above. If you wish to allow use of your version of this file only
        !            31:  * under the terms of either the GPL or the LGPL, and not to allow others to
        !            32:  * use your version of this file under the terms of the MPL, indicate your
        !            33:  * decision by deleting the provisions above and replace them with the notice
        !            34:  * and other provisions required by the GPL or the LGPL. If you do not delete
        !            35:  * the provisions above, a recipient may use your version of this file under
        !            36:  * the terms of any one of the MPL, the GPL or the LGPL.
        !            37:  *
        !            38:  * ***** END LICENSE BLOCK ***** */
        !            39: 
        !            40: /*
        !            41:  * JS runtime exception classes.
        !            42:  */
        !            43: 
        !            44: #ifndef jsexn_h___
        !            45: #define jsexn_h___
        !            46: 
        !            47: JS_BEGIN_EXTERN_C
        !            48: 
        !            49: /*
        !            50:  * Initialize the exception constructor/prototype hierarchy.
        !            51:  */
        !            52: extern JSObject *
        !            53: js_InitExceptionClasses(JSContext *cx, JSObject *obj);
        !            54: 
        !            55: /*
        !            56:  * String constants naming the exception classes.
        !            57:  */
        !            58: extern const char js_Error_str[];
        !            59: extern const char js_InternalError_str[];
        !            60: extern const char js_EvalError_str[];
        !            61: extern const char js_RangeError_str[];
        !            62: extern const char js_ReferenceError_str[];
        !            63: extern const char js_SyntaxError_str[];
        !            64: extern const char js_TypeError_str[];
        !            65: extern const char js_URIError_str[];
        !            66: 
        !            67: /*
        !            68:  * Given a JSErrorReport, check to see if there is an exception associated with
        !            69:  * the error number.  If there is, then create an appropriate exception object,
        !            70:  * set it as the pending exception, and set the JSREPORT_EXCEPTION flag on the
        !            71:  * error report.  Exception-aware host error reporters should probably ignore
        !            72:  * error reports so flagged.  Returns JS_TRUE if an associated exception is
        !            73:  * found and set, JS_FALSE otherwise..
        !            74:  */
        !            75: extern JSBool
        !            76: js_ErrorToException(JSContext *cx, const char *message, JSErrorReport *reportp);
        !            77: 
        !            78: /*
        !            79:  * Called if a JS API call to js_Execute or js_InternalCall fails; calls the
        !            80:  * error reporter with the error report associated with any uncaught exception
        !            81:  * that has been raised.  Returns true if there was an exception pending, and
        !            82:  * the error reporter was actually called.
        !            83:  *
        !            84:  * The JSErrorReport * that the error reporter is called with is currently
        !            85:  * associated with a JavaScript object, and is not guaranteed to persist after
        !            86:  * the object is collected.  Any persistent uses of the JSErrorReport contents
        !            87:  * should make their own copy.
        !            88:  *
        !            89:  * The flags field of the JSErrorReport will have the JSREPORT_EXCEPTION flag
        !            90:  * set; embeddings that want to silently propagate JavaScript exceptions to
        !            91:  * other contexts may want to use an error reporter that ignores errors with
        !            92:  * this flag.
        !            93:  */
        !            94: extern JSBool
        !            95: js_ReportUncaughtException(JSContext *cx);
        !            96: 
        !            97: extern JSErrorReport *
        !            98: js_ErrorFromException(JSContext *cx, jsval exn);
        !            99: 
        !           100: JS_END_EXTERN_C
        !           101: 
        !           102: #endif /* jsexn_h___ */

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.