Process [En cours de Traduction Wismerheal][WSL]

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) le texte à écrire
2. encoding - (Encoding) l'encodage à utiliser

• (Process) ce Processus

Définit le dossier de travail. Cela ne fonctionne que sur les processus qui ne sont pas encore lancés.

myObject.setWorkingDirectory(workingDirectory);

1. workingDirectory - (string) le texte à écrire

• (Process) ce Processus

Définit le mode du "channel" du processus. Cela ne fonctionne que sur les processus qui ne sont pas encore lancés.

myObject.setProcessChannelMode(channelMode);

1. channelMode - (ProcessChannelMode) le mode du "channel" du processus

• (Process) ce Processus

Définit les variables d'environnement du processus. Cela ne fonctionne que sur les processus qui ne sont pas encore lancés.

myObject.setEnvironment(environment);

1. environment - (object) les variables d'environnement du processus

• (Process) ce Processus

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

Met à jour les variables d'environnement du processus. Cela ne fonctionne que sur les processus qui ne sont pas encore lancés.

myObject.updateEnvironment(environment);

1. environment - (object) les variables d'environnement du processus

• (Process) ce Processus

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

Définit le "channel" du processus à lire.

myObject.setReadChannel(channel);

1. channel - (ProcessChannel) le "channel" du processus à lire

• (Process) ce Processus

Définit le fichier d'erreur standard.

myObject.setStandardErrorFile(fileName);

myObject.setStandardErrorFile(fileName, openMode);

1. fileName - (string) le nom du fichier
2. channel - (OpenMode) le mode d'ouverture du fichier (défaut: tronqué)

• (Process) ce Processus

Définit le fichier d'entrée standard.

myObject.setStandardInputFile(fileName);

1. fileName - (string) le nom du fichier

• (Process) ce Processus

Définit le fichier de sortie standard.

myObject.setStandardOutputFile(fileName);

myObject.setStandardOutputFile(fileName, openMode);

1. fileName - (string) le nom du fichier
2. channel - (OpenMode) le mode d'ouverture du fichier (défaut: tronqué)

• (Process) ce Processus

Définit la sortie standard du processus.

myObject.setStandardOutputFile(process);

1. process - (Process) la sortie du processus

• (Process) ce Processus

• (InvalidProcessError) processus non valide

Gèle l'exécution jusqu'à ce que le processus soit terminé.

myObject.waitForFinished(waitTime);

myObject.waitForFinished();

1. waitTime - (integer) le temps d'attente (en millisecondes, défaut: 30000)

• (Process) ce Processus

• (WaitForFinishedError) l'attente de la fin d'exécution à échouée

Gèle l'exécution jusqu'à ce que le processus soit lancé.

myObject.waitForStarted(waitTime);

myObject.waitForStarted();

1. waitTime - (integer) le temps d'attente (en millisecondes, défaut: 30000)

• (Process) ce Processus

• (WaitForStartedError) l'attente du lancement de l'exécution à échouée

Gèle l'exécution jusqu'à ce que les données soient écrites.

myObject.waitForBytesWritten(waitTime);

myObject.waitForBytesWritten();

1. waitTime - (integer) le temps d'attente (en millisecondes, défaut: 30000)

• (Process) ce Processus

• (WaitForBytesWrittenError) l'attente de l'écriture des bytes a échoué

Gèle l'exécution jusqu'à ce que les données soient disponibles.

myObject.waitForReadyRead(waitTime);

myObject.waitForReadyRead();

1. waitTime - (integer) le temps d'attente (en millisecondes, défaut: 30000)

• (Process) ce Processus

• (WaitForReadyReadError) l'attente pour le "prêt" en lecture a échoué

Tente de fermer le processus de manière élégante.

myObject.close();

• (Process) ce Processus

Kill (me baby!) le processus.

myObject.kill();

• (Process) ce Processus

Met fin au processus.

myObject.terminate();

• (Process) ce Processus

Appelé quand une erreur survient.

myObject.onError = function(processError) {};

1. processError - (ProcessError) le processus a rencontré une erreur

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

Appelé quand le processus s'est terminé.

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

1. exitCode - (integer) le code de sortie du processus
2. exitStatus - (ExitStatus) le statut de sortie du processus

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

==== onReadyReadStandardError ==== (au scrabble ça fait un carton :) ) Appelé quand il n'y a pas de données disponibles sur l'erreur de sortie standard.

myObject.onReadyReadStandardError = function() {};

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

Appelé quand il n'y a pas de données disponible sur la sortie standard.

myObject.onReadyReadStandardOutput = function() {};

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

Appelé quand le processus a commencé sont exécution.

myObject.onStarted = function() {};

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

Appelé quans le statut du processus a changé.

myObject.onStateChanged = function(newState) {};

1. newState - (ProcessState) le ratio du processus

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

Une erreur de processus.

1. FailedToStart: le fichier ne peut pas être trouvé ou vous ne disposez pas des autorisations suffisantes
2. Crashed: le processus a crashé après un lancement effectué avec succès (Ariane, quand tu nous tient…)
3. Timedout: la dernière attente pour la méthode … a échoué
4. WriteError: le processus n'est pas en cours d’exécution ou a possiblement fermé son "channel" d'entrée
5. ReadError: le processus n'est pas en cours d'exécution
6. UnknownError: une erreur inconnue est apparue

Le statut de sortie.

1. NormalExit: le processus s'est terminé normalement
2. CrashExit: le processus a crashé

Le statut du processus.

1. NotRunning: le processus n'est pas en cours d'exécution
2. Starting: le processus est en cours de lancement
3. Running: le processus est en cours d'exécution

Un "channel" de processus.

1. StandardOutput: le "channel" de sortie standard
2. StandardError: le channel d'erreur de sortie standard

Un mode de "channel" de processus.

1. SeparateChannels: l'erreur standard et les "channels" de sortie sont séparés
2. MergedChannels: le "channel" d'erreur standard est redirigé vers le "channel" de sortie standard
3. ForwardedChannels: la sortie de l'ensemble des "channels" est redirigée vers le processus parent

Un mode d'ouverture de "channel" de processus.

1. ReadOnly: "channel" de processus ouvert en lecture seule
2. WriteOnly: "channel" de processus ouvert en écriture seule
3. ReadWrite: "channel" de processus ouvert en lecture et écriture
4. Truncate: "channel" de processus ouvert pour écrire, et effacer tout précédent contenu
5. Text: "channel" de processus ouvert en mode texte
6. Unbuffered: "channel" de processus ouvert en mode sans-tampon