diff options
author | The Android Open Source Project <initial-contribution@android.com> | 2009-03-03 19:30:52 -0800 |
---|---|---|
committer | The Android Open Source Project <initial-contribution@android.com> | 2009-03-03 19:30:52 -0800 |
commit | 8e35f3cfc7fba1d1c829dc557ebad6409cbe16a2 (patch) | |
tree | 11425ea0b299d6fb89c6d3618a22d97d5bf68d0f /WebKit/mac/WebView/WebScriptDebugDelegate.h | |
parent | 648161bb0edfc3d43db63caed5cc5213bc6cb78f (diff) | |
download | external_webkit-8e35f3cfc7fba1d1c829dc557ebad6409cbe16a2.zip external_webkit-8e35f3cfc7fba1d1c829dc557ebad6409cbe16a2.tar.gz external_webkit-8e35f3cfc7fba1d1c829dc557ebad6409cbe16a2.tar.bz2 |
auto import from //depot/cupcake/@135843
Diffstat (limited to 'WebKit/mac/WebView/WebScriptDebugDelegate.h')
-rw-r--r-- | WebKit/mac/WebView/WebScriptDebugDelegate.h | 137 |
1 files changed, 137 insertions, 0 deletions
diff --git a/WebKit/mac/WebView/WebScriptDebugDelegate.h b/WebKit/mac/WebView/WebScriptDebugDelegate.h new file mode 100644 index 0000000..fba48f6 --- /dev/null +++ b/WebKit/mac/WebView/WebScriptDebugDelegate.h @@ -0,0 +1,137 @@ +/* + * Copyright (C) 2005 Apple Computer, Inc. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * 3. Neither the name of Apple Computer, Inc. ("Apple") nor the names of + * its contributors may be used to endorse or promote products derived + * from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY APPLE AND ITS CONTRIBUTORS "AS IS" AND ANY + * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED + * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE + * DISCLAIMED. IN NO EVENT SHALL APPLE OR ITS CONTRIBUTORS BE LIABLE FOR ANY + * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES + * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; + * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND + * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT + * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF + * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ + +#import <Foundation/Foundation.h> + +#if MAC_OS_X_VERSION_MAX_ALLOWED <= MAC_OS_X_VERSION_10_4 +#define WebNSUInteger unsigned int +#else +#define WebNSUInteger NSUInteger +#endif + +@class WebView; +@class WebFrame; +@class WebScriptCallFrame; +@class WebScriptCallFramePrivate; +@class WebScriptObject; + +extern NSString * const WebScriptErrorDomain; +extern NSString * const WebScriptErrorDescriptionKey; +extern NSString * const WebScriptErrorLineNumberKey; + +enum { + WebScriptGeneralErrorCode = -100 +}; + +// WebScriptDebugDelegate messages + +@interface NSObject (WebScriptDebugDelegate) + +// some source was parsed, establishing a "source ID" (>= 0) for future reference +// this delegate method is deprecated, please switch to the new version below +- (void)webView:(WebView *)webView didParseSource:(NSString *)source + fromURL:(NSString *)url + sourceId:(int)sid + forWebFrame:(WebFrame *)webFrame; + +// some source was parsed, establishing a "source ID" (>= 0) for future reference +- (void)webView:(WebView *)webView didParseSource:(NSString *)source + baseLineNumber:(WebNSUInteger)lineNumber + fromURL:(NSURL *)url + sourceId:(int)sid + forWebFrame:(WebFrame *)webFrame; + +// some source failed to parse +- (void)webView:(WebView *)webView failedToParseSource:(NSString *)source + baseLineNumber:(WebNSUInteger)lineNumber + fromURL:(NSURL *)url + withError:(NSError *)error + forWebFrame:(WebFrame *)webFrame; + +// just entered a stack frame (i.e. called a function, or started global scope) +- (void)webView:(WebView *)webView didEnterCallFrame:(WebScriptCallFrame *)frame + sourceId:(int)sid + line:(int)lineno + forWebFrame:(WebFrame *)webFrame; + +// about to execute some code +- (void)webView:(WebView *)webView willExecuteStatement:(WebScriptCallFrame *)frame + sourceId:(int)sid + line:(int)lineno + forWebFrame:(WebFrame *)webFrame; + +// about to leave a stack frame (i.e. return from a function) +- (void)webView:(WebView *)webView willLeaveCallFrame:(WebScriptCallFrame *)frame + sourceId:(int)sid + line:(int)lineno + forWebFrame:(WebFrame *)webFrame; + +// exception is being thrown +- (void)webView:(WebView *)webView exceptionWasRaised:(WebScriptCallFrame *)frame + sourceId:(int)sid + line:(int)lineno + forWebFrame:(WebFrame *)webFrame; +@end + + + +// WebScriptCallFrame interface +// +// These objects are passed as arguments to the debug delegate. + +@interface WebScriptCallFrame : NSObject +{ +@private + WebScriptCallFramePrivate* _private; + id _userInfo; +} + +// associate user info with frame +- (void)setUserInfo:(id)userInfo; + +// retrieve user info +- (id)userInfo; + +// get next frame on call stack (or nil if this is already the "global" frame) +- (WebScriptCallFrame *)caller; + +// get array of WebScriptObjects for each scope (innermost first, last is always global object) +- (NSArray *)scopeChain; + +// get name of function (if available) or nil +- (NSString *)functionName; + +// get pending exception (if any) or nil +- (id)exception; + +// evaluate a script (as if by "eval") in the context of this frame +- (id)evaluateWebScript:(NSString *)script; + +@end + +#undef WebNSUInteger |