WARNING: Most of this content (with the exception of the Mozilla 1.9 XPCOM reference) is very old, and can be expected to be out of date and possibly obsolete. For better XUL documentation, please visit the XUL hub at the Mozilla Developer Center.

jsdIFilter

IID:05593438-1b83-4517-864f-3cea3d37a266
Inherits From:nsISupports

Constants

These two bytes of the flags attribute are reserved for interpretation by the jsdService implementation. You can do what you like with the remaining flags.
PRUint32 FLAG_RESERVED_MASK = 255
Filters without this flag set are ignored.
PRUint32 FLAG_ENABLED = 1
Filters with this flag set are "pass" filters, they allow matching hooks to continue. Filters without this flag block matching hooks.
PRUint32 FLAG_PASS = 2

Properties

PRUint32 endLine

Line number for the end of this filter. Line numbers are one based. Assigning a 0 to this attribute will tell the debugger to ignore from startLine to the end of the file.

PRUint32 flags

FLAG_* values from above, OR'd together.

nsISupports globalObject

An nsISupports version of the global object to be filtered. A null glob matches all hooks. This attribute must be QI'able to the (non-scriptable) nsIScriptGlobalObject interface.

The jsdIService caches this value internally, so if it changes you must swap the filter with itself using jsdIService::swapFilters.

PRUint32 startLine

Line number for the start of this filter. Line numbers are one based. Assigning a 0 to this attribute will tell the debugger to ignore the entire file.

char* urlPattern

String representing the url pattern to be filtered. Supports limited glob matching, at the beginning and end of the pattern only. For example, "chrome://venkman*" filters all urls that start with chrome/venkman, "*.cgi" filters all cgi's, and "http://myserver/utils.js" filters only the utils.js file on "myserver". A null urlPattern matches all urls.

The jsdIService caches this value internally, to if it changes you must swap the filter with itself using jsdIService::swapFilters.

References

This interface is passed as an argument to the following methods:

jsdIDebuggerService.appendFilter, jsdIDebuggerService.insertFilter, jsdIDebuggerService.removeFilter, jsdIDebuggerService.swapFilters, jsdIFilterEnumerator.enumerateFilter

Reference documentation is generated from Mozilla's source.

Copyright © 1999-2006 XULPlanet.com