Cet objet vous permet de lancer et manager un processus. (programme)

Fonction de construction.

var myObject = new Process();

var myObject = new Process(parameters);

1. parameters - (object) les paramètres
   • workingDirectory - (string) le dossier de travail
   • processChannelMode - (ProcessChannelMode) le mode du "channel" du processus
   • readChannel - (ProcessChannel) le "channel" du processus à lire
   • onError - (onError) appelé quand une erreur survient
   • onFinished - (onFinished) appelé quand le processus est terminé
   • onReadyReadStandardError - (onReadyReadStandardError) appelé quand le processus dispose de données sur le "channel" d'erreur standard
   • onReadyReadStandardOutput - (onReadyReadStandardOutput) appelé quand le processus dispose de données sur le "channel" standard de sortie
   • onStarted - (onStarted) appellé quand le processus a commencé
   • onStateChanged - (onStateChanged) appelé quand l'état du processus a changé

var myObject = new Process();

var myObject = new Process({
	workingDirectory: "/home/user",
	onStarted: function()
	{
		Console.print("Started!");
	},
	onFinished: function()
	{
		Console.print("Finished!");
	}
});

Renvoie un tableau de ProcessHandle lié à tous les processus en cours d’exécution.

Process.list();

• (array) un tableau de ProcessHandle lié à tous les processus en cours d’exécution

Renvoi un ProcessHandle lié au processus d'Actionaz.

Process.thisProcess();

• (array) un ProcessHandle lié au processus d'Actionaz

Lance le processus en mode détaché et renvoie un ProcessHandle qui lui est lié. Vous aurez moins de contrôle sur le processus qu'en mode attaché, cependant il sera indépendant de l'actuelle exécution.

Process.startDetached(filename);

Process.startDetached(filename, parameters);

Process.startDetached(filename, parameters, workingDirectory);

1. filename - (string) le nom de fichier/commande du processus à lancer
2. parameters - (array) un tableau de paramètres
3. workingDirectory - (string) le dossier de travail

• (array) un ProcessHandle lié au processus lancé

• (FilenameError) nom de fichier non valide
• (StartProcessError) ne parvient pas à lancer le processus

Renvoie un ProcessHandle lié au processus lancé.

myObject.handle();

• (ProcessHandle) un ProcessHandle lié au processus lancé

Renvoie l'identifiant (id) du processus lancé.

myObject.id();

• (integer) l'identifiant (id) du processus lancé

Lance le processus.

myObject.start(filename);

myObject.start(filename, parameters);

myObject.start(filename, parameters, openMode);

1. filename - (string) le nom de fichier/commande du processus à lancer
2. parameters - (array) un tableau de paramètres
3. openMode - (OpenMode) le mode d'ouverture à utiliser (défaut: lecture & écriture)

• (Process) ce Processus

• (FilenameError) nom de fichier non valide

Renvoie l'état du processus lancé.

myObject.state();

• (ProcessState) l'état du processus lancé

Renvoie l'état de l'erreur du processus lancé.

myObject.error();

• (ProcessError) l'état de l'erreur du processus lancé

Renvoie le code de sortie du processus.

myObject.exitCode();

• (integer) le code de sortie du processus

Renvoie le statut du processus de sortie.

myObject.exitStatus();

• (ExitStatus) le statut du processus de sortie

Renvoie le contenu de l’erreur de sortie standard en un RawData .

myObject.readError();

• (RawData) le contenu de l’erreur de sortie standard en un RawData

Renvoie le contenu de la sortie standard en un RawData .

myObject.read();

• (RawData) le contenu de la sortie standard en un RawData

Renvoie le contenu d'erreur de sotie standard sous forme de texte.

myObject.readErrorText();

myObject.readErrorText(encoding);

1. encoding - (Encoding) l'encodage à utiliser

• (string) le contenu d'erreur de sotie standard sous forme de texte

Renvoie le contenu standard de sortie sous forme de texte.

myObject.readText();

myObject.readText(encoding);

1. encoding - (Encoding) l'encodage à utiliser

• (string) le contenu de sortie standard sous forme de texte

Renvoie vrai si le processus n'est pas en cours d'exécution et si aucune donnée ne peut être lue.

myObject.atEnd();

• (boolean) vrai si le processus n'est pas en cours d'exécution et si aucune donnée ne peut être lue

Renvoi le nombre de bytes qui peuvent être lus.

myObject.bytesAvailable();

• (integer) le nombre de bytes qui peuvent être lus

Renvoie le nombre de bytes qui doivent toujours être écrit.

myObject.bytesToWrite();

• (integer) le nombre de bytes qui doivent toujours être écrit

Renvoie vrai si une ligne peut être lue.

myObject.canReadLine();

• (boolean) vrai si une ligne peut être lue

Écrit des données sur le processus.

myObject.write(data);

1. data - (mixed) les données à écrire

• (Process) ce Processus

Écrit du texte sur le processus.

myObject.writeText(text, encoding);

1. text - (string) the text to write
2. encoding - (Encoding) the encoding to use

• (Process) this Process

Sets the working directory. This only works when the process is not already started.

myObject.setWorkingDirectory(workingDirectory);

1. workingDirectory - (string) the text to write

• (Process) this Process

Sets process's channel mode. This only works when the process is not already started.

myObject.setProcessChannelMode(channelMode);

1. channelMode - (ProcessChannelMode) the process's channel mode

• (Process) this Process

Sets the process's environment variables. This only works when the process is not already started.

myObject.setEnvironment(environment);

1. environment - (object) the process's environment variable

• (Process) this Process

myObject.setEnvironment({
	PATH: "c:\\;c:\\path",
	MYVAR: "hello"
});

Updates the process's environment variables. This only works when the process is not already started.

myObject.updateEnvironment(environment);

1. environment - (object) the process's environment variable

• (Process) this Process

myObject.updateEnvironment({
	PATH: "c:\\;c:\\path",
	MYVAR: "hello"
});

Sets process's read channel.

myObject.setReadChannel(channel);

1. channel - (ProcessChannel) the process's read channel

• (Process) this Process

Sets the standard error file.

myObject.setStandardErrorFile(fileName);

myObject.setStandardErrorFile(fileName, openMode);

1. fileName - (string) the filename
2. channel - (OpenMode) the file's open mode (default: Truncate)

• (Process) this Process

Sets the standard input file.

myObject.setStandardInputFile(fileName);

1. fileName - (string) the filename

• (Process) this Process

Sets the standard output file.

myObject.setStandardOutputFile(fileName);

myObject.setStandardOutputFile(fileName, openMode);

1. fileName - (string) the filename
2. channel - (OpenMode) the file's open mode (default: Truncate)

• (Process) this Process

Sets the standard output process.

myObject.setStandardOutputFile(process);

1. process - (Process) the output process

• (Process) this Process

• (InvalidProcessError) invalid process

Freezes the execution until the process has finished.

myObject.waitForFinished(waitTime);

myObject.waitForFinished();

1. waitTime - (integer) the time to wait (milliseconds, default: 30000)

• (Process) this Process

• (WaitForFinishedError) wait for finished failed

Freezes the execution until the process has started.

myObject.waitForStarted(waitTime);

myObject.waitForStarted();

1. waitTime - (integer) the time to wait (milliseconds, default: 30000)

• (Process) this Process

• (WaitForStartedError) wait for started failed

Freezes the execution until the data has been written.

myObject.waitForBytesWritten(waitTime);

myObject.waitForBytesWritten();

1. waitTime - (integer) the time to wait (milliseconds, default: 30000)

• (Process) this Process

• (WaitForBytesWrittenError) wait for bytes written failed

Freezes the execution until data is available.

myObject.waitForReadyRead(waitTime);

myObject.waitForReadyRead();

1. waitTime - (integer) the time to wait (milliseconds, default: 30000)

• (Process) this Process

• (WaitForReadyReadError) wait for ready read failed

Tries to close the process gracefully.

myObject.close();

• (Process) this Process

Kills the process.

myObject.kill();

• (Process) this Process

Terminates the process.

myObject.terminate();

• (Process) this Process

Called when an error occured.

myObject.onError = function(processError) {};

1. processError - (ProcessError) the process error that has occured

myObject.onError = function(processError)
{
	//Event action
};

Called when the process has finished.

myObject.onFinished = function(exitCode, exitStatus) {};

1. exitCode - (integer) the process's exit code
2. exitStatus - (ExitStatus) the process's exit status

myObject.onFinished = function(exitCode, exitStatus)
{
	//Event action
};

Called when there is data available on the standard error output.

myObject.onReadyReadStandardError = function() {};

myObject.onReadyReadStandardError = function()
{
	//Event action
};

Called when there is data available on the standard output.

myObject.onReadyReadStandardOutput = function() {};

myObject.onReadyReadStandardOutput = function()
{
	//Event action
};

Called when the process has started executing.

myObject.onStarted = function() {};

myObject.onStarted = function()
{
	//Event action
};

Called when the process's state has changed.

myObject.onStateChanged = function(newState) {};

1. newState - (ProcessState) the process's state

myObject.onStateChanged = function(newState)
{
	//Event action
};

A process error.

1. FailedToStart: the file cannot be found or insufficient permissions
2. Crashed: the process has crashed after having started successfully
3. Timedout: the last waitFor… method failed
4. WriteError: the process is not running or it may have closed it's input channel
5. ReadError: the process is not running
6. UnknownError: an unknown error has occured

The process's exit status.

1. NormalExit: the process finished normally
2. CrashExit: the process crashed

The process's status.

1. NotRunning: the process is not running
2. Starting: the process is starting
3. Running: the process is running

A process's channel.

1. StandardOutput: the standard output channel
2. StandardError: the standard error output channel

A process's channel mode.

1. SeparateChannels: the standard error and output channels are separated
2. MergedChannels: the standard error channel is redirected to the the standard output channel
3. ForwardedChannels: the output of both channels is redirected to the parent process

A process's channel open mode.

1. ReadOnly: process channel opened for reading only
2. WriteOnly: process channel opened for writing only
3. ReadWrite: process channel opened for reading and writing
4. Truncate: process channel opened for writing, erases any previous content
5. Text: process channel opened in text mode
6. Unbuffered: process channel opened in unbuffered mode