mozilla
Your Search Results

    JSExtendedClass

    Obsolete since JavaScript 1.8.5
    This feature is obsolete. Although it may still work in some browsers, its use is discouraged since it could be removed at any time. Try to avoid using it.

    JSExtendedClass is an extended version of JSClass with additional hooks.

    A C/C++ program can use a JSExtendedClass with the JS_InitClass and JS_NewObject APIs to create objects that have custom methods and properties implemented in C/C++.

    Syntax

    struct JSExtendedClass {
       JSClass             base;
       JSEqualityOp        equality;
       JSObjectOp          outerObject;
       JSObjectOp          innerObject;
       JSIteratorOp        iteratorObject;// Added in SpiderMonkey 1.8
       JSObjectOp          wrappedObject; // Added in SpiderMonkey 1.8
    
       ...and additional reserved fields.
    };
    
    Name Type Description
    base JSClass The basic class information and callbacks for this class. This contains some required fields.
    equality JSEqualityOp Optional. Overrides the JavaScript == and != operators.
    outerObject JSObjectOp Optional. Return the current outer object. This is used to implement split objects.
    innerObject JSObjectOp Optional. Return the current inner object. This is used to implement split objects.
    iteratorObject JSIteratorOp Added in SpiderMonkey 1.8 Optional. Creates and returns a new iterator.
    wrappedObject JSObjectOp Added in SpiderMonkey 1.8 Optional. If non-null, an object of this class may serve as a wrapper for another object. Wrappers sometimes transparently behave like the object they wrap. For example, an object and its wrappers are all equal under ===.

    Description

    To implement a custom class that uses any of the JSExtendedClass callbacks:

    • Create a JSExtendedClass and populate both the base fields and the extended fields.
    • Ensure that the additional reserved fields at the end of the JSExtendedClass are NULL. JSClass and JSExtendedClass structs should usually be global, and in this case the compiler automatically initializes these fields to NULL. (This is a feature of the C and C++ languages.) Otherwise, use memset.
    • Set the JSCLASS_IS_EXTENDED flag in myExtendedClass.base.flags.
    • Pass &myExtendedClass.base to functions like JS_InitClass or JS_NewObject that require a JSClass *.

    See Also

    Document Tags and Contributors

    Contributors to this page: fscholz, Jorend, tschneidereit, arai
    Last updated by: arai,
    Hide Sidebar