2001-09-20 00:02:59 +00:00
|
|
|
/* -*- Mode: C; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 4 -*-
|
1999-03-23 20:22:00 +00:00
|
|
|
*
|
2003-11-15 00:11:16 +00:00
|
|
|
* ***** BEGIN LICENSE BLOCK *****
|
|
|
|
* Version: MPL 1.1/GPL 2.0/LGPL 2.1
|
1999-03-23 20:22:00 +00:00
|
|
|
*
|
2003-11-15 00:11:16 +00:00
|
|
|
* The contents of this file are subject to the Mozilla Public License Version
|
|
|
|
* 1.1 (the "License"); you may not use this file except in compliance with
|
|
|
|
* the License. You may obtain a copy of the License at
|
|
|
|
* http://www.mozilla.org/MPL/
|
|
|
|
*
|
|
|
|
* Software distributed under the License is distributed on an "AS IS" basis,
|
|
|
|
* WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
|
|
|
|
* for the specific language governing rights and limitations under the
|
|
|
|
* License.
|
1999-03-23 20:22:00 +00:00
|
|
|
*
|
2001-09-20 00:02:59 +00:00
|
|
|
* The Original Code is Mozilla Communicator client code, released
|
|
|
|
* March 31, 1998.
|
1999-09-28 23:12:09 +00:00
|
|
|
*
|
2003-11-15 00:11:16 +00:00
|
|
|
* The Initial Developer of the Original Code is
|
|
|
|
* Netscape Communications Corporation.
|
|
|
|
* Portions created by the Initial Developer are Copyright (C) 1998
|
|
|
|
* the Initial Developer. All Rights Reserved.
|
1999-09-28 23:12:09 +00:00
|
|
|
*
|
Landing the XPCDOM_20010329_BRANCH branch, changes mostly done by jband@netscape.com and jst@netscape.com, also some changes done by shaver@mozilla.org, peterv@netscape.com and markh@activestate.com. r= and sr= by vidur@netscape.com, jband@netscape.com, jst@netscpae.com, danm@netscape.com, hyatt@netscape.com, shaver@mozilla.org, dbradley@netscape.com, rpotts@netscape.com.
2001-05-08 17:42:36 +00:00
|
|
|
* Contributor(s):
|
|
|
|
* John Bandhauer <jband@netscape.com> (original author)
|
1999-09-28 23:12:09 +00:00
|
|
|
*
|
2003-11-15 00:11:16 +00:00
|
|
|
* Alternatively, the contents of this file may be used under the terms of
|
|
|
|
* either of the GNU General Public License Version 2 or later (the "GPL"),
|
|
|
|
* or the GNU Lesser General Public License Version 2.1 or later (the "LGPL"),
|
|
|
|
* in which case the provisions of the GPL or the LGPL are applicable instead
|
|
|
|
* of those above. If you wish to allow use of your version of this file only
|
|
|
|
* under the terms of either the GPL or the LGPL, and not to allow others to
|
|
|
|
* use your version of this file under the terms of the MPL, indicate your
|
|
|
|
* decision by deleting the provisions above and replace them with the notice
|
|
|
|
* and other provisions required by the GPL or the LGPL. If you do not delete
|
|
|
|
* the provisions above, a recipient may use your version of this file under
|
|
|
|
* the terms of any one of the MPL, the GPL or the LGPL.
|
|
|
|
*
|
|
|
|
* ***** END LICENSE BLOCK ***** */
|
1999-03-23 20:22:00 +00:00
|
|
|
|
|
|
|
#include "nsISupports.idl"
|
1999-07-15 05:42:53 +00:00
|
|
|
#include "xpcexception.idl"
|
2000-02-15 06:43:51 +00:00
|
|
|
#include "xpcjsid.idl"
|
1999-09-11 05:21:30 +00:00
|
|
|
#include "nsIComponentManager.idl"
|
1999-03-23 20:22:00 +00:00
|
|
|
|
2011-05-03 20:43:08 +00:00
|
|
|
%{C++
|
|
|
|
#include "jspubtd.h"
|
|
|
|
%}
|
|
|
|
|
2007-07-06 20:13:12 +00:00
|
|
|
interface xpcIJSWeakReference;
|
|
|
|
|
2011-08-16 20:57:23 +00:00
|
|
|
/**
|
|
|
|
* interface of Components.interfacesByID
|
|
|
|
* (interesting stuff only reflected into JavaScript)
|
|
|
|
*/
|
|
|
|
[scriptable, uuid(c99cffac-5aed-4267-ad2f-f4a4c9d4a081)]
|
|
|
|
interface nsIXPCComponents_InterfacesByID : nsISupports
|
|
|
|
{
|
|
|
|
};
|
|
|
|
|
|
|
|
/**
|
|
|
|
* interface of Components.interfaces
|
|
|
|
* (interesting stuff only reflected into JavaScript)
|
|
|
|
*/
|
|
|
|
[scriptable, uuid(b8c31bba-79db-4a1d-930d-4cdd68713f9e)]
|
|
|
|
interface nsIXPCComponents_Interfaces : nsISupports
|
|
|
|
{
|
|
|
|
};
|
|
|
|
|
2000-02-15 06:43:51 +00:00
|
|
|
/**
|
|
|
|
* interface of Components.classes
|
|
|
|
* (interesting stuff only reflected into JavaScript)
|
|
|
|
*/
|
1999-04-06 22:42:10 +00:00
|
|
|
[scriptable, uuid(978ff520-d26c-11d2-9842-006008962422)]
|
2000-02-15 06:43:51 +00:00
|
|
|
interface nsIXPCComponents_Classes : nsISupports
|
1999-03-23 20:22:00 +00:00
|
|
|
{
|
|
|
|
};
|
|
|
|
|
2000-02-15 06:43:51 +00:00
|
|
|
/**
|
|
|
|
* interface of Components.classesByID
|
|
|
|
* (interesting stuff only reflected into JavaScript)
|
|
|
|
*/
|
1999-08-09 05:02:25 +00:00
|
|
|
[scriptable, uuid(336a9590-4d19-11d3-9893-006008962422)]
|
2000-02-15 06:43:51 +00:00
|
|
|
interface nsIXPCComponents_ClassesByID : nsISupports
|
1999-08-09 05:02:25 +00:00
|
|
|
{
|
|
|
|
};
|
|
|
|
|
2000-02-15 06:43:51 +00:00
|
|
|
/**
|
|
|
|
* interface of Components.results
|
|
|
|
* (interesting stuff only reflected into JavaScript)
|
|
|
|
*/
|
1999-08-22 23:56:42 +00:00
|
|
|
[scriptable, uuid(2fc229a0-5860-11d3-9899-006008962422)]
|
2000-02-15 06:43:51 +00:00
|
|
|
interface nsIXPCComponents_Results : nsISupports
|
1999-08-22 23:56:42 +00:00
|
|
|
{
|
|
|
|
};
|
1999-04-03 10:12:50 +00:00
|
|
|
|
2000-02-15 06:43:51 +00:00
|
|
|
/**
|
|
|
|
* interface of Components.ID
|
|
|
|
* (interesting stuff only reflected into JavaScript)
|
|
|
|
*/
|
|
|
|
[scriptable, uuid(7994a6e0-e028-11d3-8f5d-0010a4e73d9a)]
|
|
|
|
interface nsIXPCComponents_ID : nsISupports
|
|
|
|
{
|
|
|
|
};
|
|
|
|
|
|
|
|
/**
|
|
|
|
* interface of Components.Exception
|
|
|
|
* (interesting stuff only reflected into JavaScript)
|
|
|
|
*/
|
|
|
|
[scriptable, uuid(5bf039c0-e028-11d3-8f5d-0010a4e73d9a)]
|
|
|
|
interface nsIXPCComponents_Exception : nsISupports
|
|
|
|
{
|
|
|
|
};
|
|
|
|
|
|
|
|
/**
|
Landing the XPCDOM_20010329_BRANCH branch, changes mostly done by jband@netscape.com and jst@netscape.com, also some changes done by shaver@mozilla.org, peterv@netscape.com and markh@activestate.com. r= and sr= by vidur@netscape.com, jband@netscape.com, jst@netscpae.com, danm@netscape.com, hyatt@netscape.com, shaver@mozilla.org, dbradley@netscape.com, rpotts@netscape.com.
2001-05-08 17:42:36 +00:00
|
|
|
* interface of Components.Constructor
|
2000-02-15 06:43:51 +00:00
|
|
|
* (interesting stuff only reflected into JavaScript)
|
|
|
|
*/
|
|
|
|
[scriptable, uuid(88655640-e028-11d3-8f5d-0010a4e73d9a)]
|
|
|
|
interface nsIXPCComponents_Constructor : nsISupports
|
|
|
|
{
|
|
|
|
};
|
|
|
|
|
|
|
|
/**
|
Landing the XPCDOM_20010329_BRANCH branch, changes mostly done by jband@netscape.com and jst@netscape.com, also some changes done by shaver@mozilla.org, peterv@netscape.com and markh@activestate.com. r= and sr= by vidur@netscape.com, jband@netscape.com, jst@netscpae.com, danm@netscape.com, hyatt@netscape.com, shaver@mozilla.org, dbradley@netscape.com, rpotts@netscape.com.
2001-05-08 17:42:36 +00:00
|
|
|
* interface of object returned by Components.Constructor
|
2000-02-15 06:43:51 +00:00
|
|
|
* (additional interesting stuff only reflected into JavaScript)
|
|
|
|
*/
|
|
|
|
[scriptable, uuid(c814ca20-e0dc-11d3-8f5f-0010a4e73d9a)]
|
|
|
|
interface nsIXPCConstructor : nsISupports
|
|
|
|
{
|
|
|
|
readonly attribute nsIJSCID classID;
|
|
|
|
readonly attribute nsIJSIID interfaceID;
|
|
|
|
readonly attribute string initializer;
|
|
|
|
};
|
|
|
|
|
2005-08-25 16:38:58 +00:00
|
|
|
/**
|
|
|
|
* interface of object returned by Components.utils.Sandbox.
|
|
|
|
*/
|
|
|
|
[scriptable, uuid(4f8ae0dc-d266-4a32-875b-6a9de71a8ce9)]
|
|
|
|
interface nsIXPCComponents_utils_Sandbox : nsISupports
|
|
|
|
{
|
|
|
|
};
|
|
|
|
|
2011-07-01 06:08:48 +00:00
|
|
|
/**
|
|
|
|
* interface for callback to be passed to Cu.schedulePreciseGC
|
|
|
|
*/
|
|
|
|
[scriptable, function, uuid(71000535-b0fd-44d1-8ce0-909760e3953c)]
|
|
|
|
interface ScheduledGCCallback : nsISupports
|
|
|
|
{
|
|
|
|
void callback();
|
|
|
|
};
|
|
|
|
|
2000-02-15 06:43:51 +00:00
|
|
|
/**
|
2005-07-07 19:34:35 +00:00
|
|
|
* interface of Components.utils
|
2000-02-15 06:43:51 +00:00
|
|
|
*/
|
2011-07-01 06:08:48 +00:00
|
|
|
[scriptable, uuid(fed2d752-6cb3-4135-97b0-2c290e541e2d)]
|
2005-07-07 19:34:35 +00:00
|
|
|
interface nsIXPCComponents_Utils : nsISupports
|
1999-03-23 20:22:00 +00:00
|
|
|
{
|
1999-04-03 10:12:50 +00:00
|
|
|
|
2005-06-29 14:23:03 +00:00
|
|
|
/* reportError is designed to be called from JavaScript only.
|
|
|
|
*
|
|
|
|
* It will report a JS Error object to the JS console, and return. It
|
|
|
|
* is meant for use in exception handler blocks which want to "eat"
|
|
|
|
* an exception, but still want to report it to the console.
|
|
|
|
*
|
|
|
|
* It must be called with one param, usually an object which was caught by
|
|
|
|
* an exception handler. If it is not a JS error object, the parameter
|
|
|
|
* is converted to a string and reported as a new error.
|
|
|
|
*/
|
|
|
|
void reportError();
|
Landing the XPCDOM_20010329_BRANCH branch, changes mostly done by jband@netscape.com and jst@netscape.com, also some changes done by shaver@mozilla.org, peterv@netscape.com and markh@activestate.com. r= and sr= by vidur@netscape.com, jband@netscape.com, jst@netscpae.com, danm@netscape.com, hyatt@netscape.com, shaver@mozilla.org, dbradley@netscape.com, rpotts@netscape.com.
2001-05-08 17:42:36 +00:00
|
|
|
|
2002-08-07 23:39:11 +00:00
|
|
|
/* lookupMethod is designed to be called from JavaScript only.
|
|
|
|
*
|
|
|
|
* It returns a method looking only at the idl interfaces and
|
|
|
|
* ignores any overrides or resolvers that might be in place for
|
|
|
|
* a given scriptable wrapped native.
|
|
|
|
* It must be called with two params: an object and a method name.
|
|
|
|
* It returns a function object or throws an exception on error.
|
|
|
|
* This method exists only to solve mozilla browser problems
|
|
|
|
* when chrome attempts to lookup and call methods in content
|
|
|
|
* and *must* not get confused by method properties that have been
|
|
|
|
* replaced in the content JS code. This method is not recommended for
|
|
|
|
* any other use.
|
|
|
|
*/
|
|
|
|
void lookupMethod();
|
|
|
|
|
2005-08-25 16:38:58 +00:00
|
|
|
readonly attribute nsIXPCComponents_utils_Sandbox Sandbox;
|
|
|
|
|
2005-06-29 14:23:03 +00:00
|
|
|
/*
|
2007-05-22 21:57:42 +00:00
|
|
|
* evalInSandbox is designed to be called from JavaScript only.
|
2005-04-25 18:45:11 +00:00
|
|
|
*
|
2005-08-25 16:38:58 +00:00
|
|
|
* evalInSandbox evaluates the provided source string in the given sandbox.
|
|
|
|
* It returns the result of the evaluation to the caller.
|
2005-04-25 18:45:11 +00:00
|
|
|
*
|
2005-08-25 16:38:58 +00:00
|
|
|
* var s = new C.u.Sandbox("http://www.mozilla.org");
|
|
|
|
* var res = C.u.evalInSandbox("var five = 5; 2 + five", s);
|
2005-06-29 14:23:03 +00:00
|
|
|
* var outerFive = s.five;
|
2005-08-25 16:38:58 +00:00
|
|
|
* s.seven = res;
|
|
|
|
* var thirtyFive = C.u.evalInSandbox("five * seven", s);
|
2005-06-29 14:23:03 +00:00
|
|
|
*/
|
2005-08-25 16:38:58 +00:00
|
|
|
void evalInSandbox(in AString source/*, obj */);
|
2007-05-15 23:27:40 +00:00
|
|
|
|
|
|
|
|
|
|
|
/*
|
2007-05-22 21:57:42 +00:00
|
|
|
* import is designed to be called from JavaScript only.
|
2007-05-15 23:27:40 +00:00
|
|
|
*
|
2007-05-22 21:57:42 +00:00
|
|
|
* Synchronously loads and evaluates the js file located at
|
|
|
|
* 'registryLocation' with a new, fully privileged global object.
|
2007-07-15 18:21:11 +00:00
|
|
|
*
|
|
|
|
* If 'targetObj' is specified and equal to null, returns the
|
|
|
|
* module's global object. Otherwise (if 'targetObj' is not
|
|
|
|
* specified, or 'targetObj' is != null) looks for a property
|
|
|
|
* 'EXPORTED_SYMBOLS' on the new global object. 'EXPORTED_SYMBOLS'
|
|
|
|
* is expected to be an array of strings identifying properties on
|
|
|
|
* the global object. These properties will be installed as
|
|
|
|
* properties on 'targetObj', or, if 'targetObj' is not specified,
|
|
|
|
* on the caller's global object. If 'EXPORTED_SYMBOLS' is not
|
|
|
|
* found, an error is thrown.
|
2007-05-15 23:27:40 +00:00
|
|
|
*
|
2007-07-14 21:43:35 +00:00
|
|
|
* @param resourceURI A resource:// URI string to load the module from.
|
2007-05-22 21:57:42 +00:00
|
|
|
* @param targetObj the object to install the exported properties on.
|
2007-07-15 18:21:11 +00:00
|
|
|
* If this parameter is a primitive value, this method throws
|
|
|
|
* an exception.
|
|
|
|
* @returns the module code's global object.
|
2007-05-22 21:57:42 +00:00
|
|
|
*
|
|
|
|
* The implementation maintains a hash of registryLocation->global obj.
|
|
|
|
* Subsequent invocations of importModule with 'registryLocation'
|
|
|
|
* pointing to the same file will not cause the module to be re-evaluated,
|
2007-05-15 23:27:40 +00:00
|
|
|
* but the symbols in EXPORTED_SYMBOLS will be exported into the
|
2007-05-22 21:57:42 +00:00
|
|
|
* specified target object and the global object returned as above.
|
|
|
|
*
|
|
|
|
* (This comment is duplicated from xpcIJSModuleLoader.)
|
2007-05-15 23:27:40 +00:00
|
|
|
*/
|
|
|
|
void /* JSObject */ import(in AUTF8String registryLocation
|
|
|
|
/*, [optional] in JSObject targetObj */);
|
2007-07-06 20:13:12 +00:00
|
|
|
|
2011-06-15 18:08:43 +00:00
|
|
|
/*
|
|
|
|
* Unloads the JS module at 'registryLocation'. Existing references to the
|
|
|
|
* module will continue to work but any subsequent import of the module will
|
|
|
|
* reload it and give new reference. If the JS module hasn't yet been
|
|
|
|
* imported then this method will do nothing.
|
|
|
|
*
|
|
|
|
* @param resourceURI A resource:// URI string to unload the module from.
|
|
|
|
*/
|
|
|
|
void unload(in AUTF8String registryLocation);
|
|
|
|
|
2007-07-06 20:13:12 +00:00
|
|
|
/*
|
|
|
|
* To be called from JS only.
|
|
|
|
*
|
|
|
|
* Return a weak reference for the given JS object.
|
|
|
|
*/
|
|
|
|
xpcIJSWeakReference getWeakReference(/* in JSObject obj */);
|
|
|
|
|
|
|
|
/*
|
|
|
|
* To be called from JS only.
|
|
|
|
*
|
|
|
|
* Force an immediate garbage collection cycle.
|
|
|
|
*/
|
|
|
|
void forceGC();
|
2010-04-28 20:53:01 +00:00
|
|
|
|
2011-07-01 06:08:48 +00:00
|
|
|
/*
|
|
|
|
* Schedule a garbage collection cycle for a point in the future when no JS
|
|
|
|
* is running. Call the provided function once this has occurred.
|
|
|
|
*/
|
|
|
|
[implicit_jscontext]
|
|
|
|
void schedulePreciseGC(in ScheduledGCCallback callback);
|
|
|
|
|
2010-04-28 20:53:01 +00:00
|
|
|
/*
|
|
|
|
* To be called from JS only.
|
|
|
|
*
|
|
|
|
* Returns the global object with which the given object is associated.
|
|
|
|
*
|
2010-04-28 22:54:28 +00:00
|
|
|
* @param obj The JavaScript object whose global is to be gotten.
|
2010-04-28 20:53:01 +00:00
|
|
|
* @return the corresponding global.
|
|
|
|
*/
|
|
|
|
void /* JSObject */ getGlobalForObject(/* in JSObject obj */);
|
2011-05-03 20:43:08 +00:00
|
|
|
|
|
|
|
/*
|
|
|
|
* To be called from JS only.
|
|
|
|
*
|
|
|
|
* Returns an object created in |vobj|'s compartment.
|
|
|
|
*/
|
|
|
|
[implicit_jscontext]
|
|
|
|
jsval createObjectIn(in jsval vobj);
|
|
|
|
|
|
|
|
/*
|
|
|
|
* To be called from JS only.
|
|
|
|
*
|
|
|
|
* Ensures that all functions come from vobj's scope (and aren't cross
|
|
|
|
* compartment wrappers).
|
|
|
|
*/
|
|
|
|
[implicit_jscontext]
|
|
|
|
void makeObjectPropsNormal(in jsval vobj);
|
2005-06-29 14:23:03 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
/**
|
|
|
|
* interface of JavaScript's 'Components' object
|
|
|
|
*/
|
|
|
|
[scriptable, uuid(155809f1-71f1-47c5-be97-d812ba560405)]
|
|
|
|
interface nsIXPCComponents : nsISupports
|
|
|
|
{
|
2011-08-16 20:57:23 +00:00
|
|
|
readonly attribute nsIXPCComponents_Interfaces interfaces;
|
|
|
|
readonly attribute nsIXPCComponents_InterfacesByID interfacesByID;
|
|
|
|
readonly attribute nsIXPCComponents_Classes classes;
|
|
|
|
readonly attribute nsIXPCComponents_ClassesByID classesByID;
|
|
|
|
readonly attribute nsIStackFrame stack;
|
|
|
|
readonly attribute nsIXPCComponents_Results results;
|
|
|
|
readonly attribute nsIComponentManager manager;
|
|
|
|
readonly attribute nsIXPCComponents_Utils utils;
|
|
|
|
|
|
|
|
readonly attribute nsIXPCComponents_ID ID;
|
|
|
|
readonly attribute nsIXPCComponents_Exception Exception;
|
|
|
|
readonly attribute nsIXPCComponents_Constructor Constructor;
|
2005-06-29 14:23:03 +00:00
|
|
|
|
|
|
|
boolean isSuccessCode(in nsresult result);
|
|
|
|
|
2011-03-28 03:59:44 +00:00
|
|
|
/* @deprecated Use Components.utils.lookupMethod instead.
|
2005-06-29 14:23:03 +00:00
|
|
|
* (But are you sure you really want this method any more?
|
|
|
|
* See http://developer-test.mozilla.org/en/docs/XPCNativeWrapper )
|
2005-04-25 18:45:11 +00:00
|
|
|
*/
|
2011-03-28 03:59:44 +00:00
|
|
|
[deprecated] void lookupMethod();
|
2005-06-29 14:23:03 +00:00
|
|
|
|
2011-03-28 03:59:44 +00:00
|
|
|
/* @deprecated Use Components.utils.reportError instead. */
|
|
|
|
[deprecated] void reportError();
|
2005-04-25 18:45:11 +00:00
|
|
|
|
2005-11-21 06:30:34 +00:00
|
|
|
/* 'lastResult' is accessible via JavaScript only */
|
|
|
|
/* 'returnCode' is accessible via JavaScript only */
|
1999-03-23 20:22:00 +00:00
|
|
|
};
|