nsIProcess

Implemented by: @mozilla.org/process/util;1. To create an instance, use:

var process = Components.classes["@mozilla.org/process/util;1"]
              .createInstance(Components.interfaces.nsIProcess);

Method overview

属性

方法

init()

Initializes the nsIProcess with the specified executable file. Once initialized, you can start the process executing by calling run().

void init(
  in nsIFile executable
);

参数

executable

The nsIFile executable file to be represented by the nsIProcess object.

Initializes the nsIProcess to represent an existing process, given that process's ID.

void initWithPid(
  in unsigned long pid
);

参数

pid

The process ID to begin to represent.

kill()

立即终止该nsIProcess对象所代表的进程,只在该进程是非阻塞方式启动的情况下才有效.

void kill();

参数

无.

run()

开始执行进程.

void run(
  in boolean blocking,
  [array, size_is(count)] in string args,
  in unsigned long count
);

参数

blocking

如果为true,则该方法会阻塞,直到所打开的进程关闭为止,如果为false,则该方法会立即返回.

args

An array of count arguments, using the native character set, to be passed to the executable on its command line.

count

参数args中的参数个数.

Asynchronously runs the process with which the object was initialized, optionally calling an observer when the process finishes running.

void runAsync(
  [array, size_is(count)] in string args,
  in unsigned long count,
  in nsIObserver observer, 可选
  in boolean holdWeak 可选
);

Parameters

args

An array of arguments to pass into the process, using the native character set. This array must have count entries.

count

The number of arguments passed in the args array.

observer 可选

An observer that will be notified when the process exits. The observer will receive this nsIProcess instance as the subject and "process-finished" or "process-failed" as the topic. The observer will be notified on the main thread.

holdWeak 可选

If true, a weak reference is used to hold the observer.

 

Executes the file this object was initialized with.

void runw(
  in boolean blocking,
  [array, size_is(count)] in wstring args,
  in unsigned long count
);

Parameters

blocking

If true, this method will block until the process terminates; if false, the method returns immediately.

args

An array of count arguments, using UTF-16, to be passed to the executable on its command line.

count

The number of arguments in the args array.

Asynchronously runs the process with which the object was initialized, optionally calling an observer when the process finishes running.

void runwAsync(
  [array, size_is(count)] in wstring args,
  in unsigned long count,
  in nsIObserver observer, 可选
  in boolean holdWeak 可选
);

Parameters

args

An array of arguments to pass into the process, using UTF-16. This array must have count entries.

count

The number of arguments passed in the args array.

observer 可选

An observer that will be notified when the process exits. The observer will receive this nsIProcess instance as the subject and "process-finished" or "process-failed" as the topic. The observer will be notified on the main thread.

holdWeak 可选

If true, a weak reference is used to hold the observer.

Example

// create an nsILocalFile for the executable
var file = Components.classes["@mozilla.org/file/local;1"]
                     .createInstance(Components.interfaces.nsILocalFile);
file.initWithPath("c:\\myapp.exe");

// create an nsIProcess
var process = Components.classes["@mozilla.org/process/util;1"]
                        .createInstance(Components.interfaces.nsIProcess);
process.init(file);

// Run the process.
// If first param is true, calling thread will be blocked until
// called process terminates.
// Second and third params are used to pass command-line arguments
// to the process.
var args = ["argument1", "argument2"];
process.run(false, args, args.length);

See also

• nsIFile
• nsILocalFile
• nsIProcess2 已废弃 Gecko 1.9.2