Changeset 14932 in webkit for trunk/JavaScriptCore/bindings/objc/WebScriptObject.h

Timestamp:

Jun 20, 2006, 5:20:00 PM (19 years ago)

Author:

thatcher

Message:

Reviewed by Geoff.

Make sure we clear the exception before returning so
that future calls will not fail because of an earlier
exception state. Assert on entry that the WebScriptObject
is working with an ExecState that dose not have an exception.
Document that evaluateWebScript and callWebScriptMethod return
WebUndefined when an exception is thrown.

• bindings/objc/WebScriptObject.h:
• bindings/objc/WebScriptObject.mm: (-[WebScriptObject callWebScriptMethod:withArguments:]): (-[WebScriptObject evaluateWebScript:]): (-[WebScriptObject setValue:forKey:]): (-[WebScriptObject valueForKey:]): (-[WebScriptObject removeWebScriptKey:]): (-[WebScriptObject webScriptValueAtIndex:]): (-[WebScriptObject setWebScriptValueAtIndex:value:]):

File:

• trunk/JavaScriptCore/bindings/objc/WebScriptObject.h (modified) (3 diffs)

trunk/JavaScriptCore/bindings/objc/WebScriptObject.h

@@ -188 +188 @@
     specified arguments.
     @result Returns the result of calling the script method.
+    Returns WebUndefined when an exception is thrown in the script environment.
 */
 - (id)callWebScriptMethod:(NSString *)name withArguments:(NSArray *)args;
@@ -197 +198 @@
     of the script is dependent of the target script environment.
     @result Returns the result of evaluating the script in the script environment.
+    Returns WebUndefined when an exception is thrown in the script environment.
 */
 - (id)evaluateWebScript:(NSString *)script;
@@ -219 +221 @@
     @param index The index of the property to return.  Index based access is dependent 
     @discussion Gets the value of the property at the specified index.
-    @result The value of the property.
+    @result The value of the property. Returns WebUndefined when an exception is
+    thrown in the script environment.
 */
 - (id)webScriptValueAtIndex:(unsigned int)index;