Changeset 15483 in webkit for trunk/JavaScriptCore/API/JSObjectRef.h

Timestamp:

Jul 17, 2006, 2:06:57 AM (19 years ago)

Author:

ggaren

Message:

Reviewed by Maciej.

• Changed the initialize callback to run from least derived class (parent class) to most derived class. This enables C++ style initialization, and derived class overriding of member data.

• Added excpetion propopgation to JSObjectMake, to support initialize exceptions, and generally round out our policy of making function signatures as long as possible.

• API/JSCallbackObject.h: Use ExecState instead of ContextRef, cuz we're in C++ land now.

File:

• trunk/JavaScriptCore/API/JSObjectRef.h (modified) (4 diffs)

trunk/JavaScriptCore/API/JSObjectRef.h

@@ -67 +67 @@
 
 void Initialize(JSContextRef ctx, JSObjectRef object, JSValueRef* exception);
+
+Unlike the other object callbacks, the initialize callback is called on the least
+derived class (the parent class) first, and the most derived class last.
 */
 typedef void
@@ -78 +81 @@
 
 void Finalize(JSObjectRef object);
+
+The finalize callback is called on the most derived class first, and the least 
+derived class (the parent class) last.
 */
 typedef void            
@@ -225 +231 @@
 @param exception A pointer to a JSValueRef in which to return an exception, if any.
 @result true if possibleInstance is an instance of constructor, otherwise false.
-
 @discussion If you named your function HasInstance, you would declare it like this:
 
@@ -379 +384 @@
 @param jsClass The JSClass to assign to the object. Pass NULL to use the default object class.
 @param prototype The prototype to assign to the object. Pass NULL to use the default object prototype.
+@param exception A pointer to a JSValueRef in which to store an exception, if any. Pass NULL if you do not care to store an exception.
 @result A JSObject with the given class and prototype.
 */
-JSObjectRef JSObjectMake(JSContextRef ctx, JSClassRef jsClass, JSValueRef prototype);
+JSObjectRef JSObjectMake(JSContextRef ctx, JSClassRef jsClass, JSValueRef prototype, JSValueRef* exception);
 
 /*!