Outils pour utilisateurs

Outils du site


fr:code:system:process

Process [En cours de Traduction Wismerheal][WSL]

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

Fonctions

Process

Fonction de construction.

Syntaxe

var myObject = new Process();
var myObject = new Process(parameters);

Arguments

  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é

Example

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

list

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

Syntaxe

Process.list();

Renvoie

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

thisProcess

Renvoi un ProcessHandle lié au processus d'Actionaz.

Syntaxe

Process.thisProcess();

Renvoie

startDetached

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.

Syntaxe

Process.startDetached(filename);
Process.startDetached(filename, parameters);
Process.startDetached(filename, parameters, workingDirectory);

Arguments

  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

Renvoie

Exceptions

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

Méthodes

handle

Renvoie un ProcessHandle lié au processus lancé.

Syntaxe

myObject.handle();

Renvoie

id

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

Syntaxe

myObject.id();

REnvoie

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

start

Lance le processus.

Syntaxe

myObject.start(filename);
myObject.start(filename, parameters);
myObject.start(filename, parameters, openMode);

Arguments

  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)

Renvoie

  • (Process) ce Processus

Exceptions

  • (FilenameError) nom de fichier non valide

state

Renvoie l'état du processus lancé.

Syntaxe

myObject.state();

Renvoie

error

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

Syntaxe

myObject.error();

Renvoie

exitCode

Renvoie le code de sortie du processus.

Syntaxe

myObject.exitCode();

Renvoie

  • (integer) le code de sortie du processus

exitStatus

Renvoie le statut du processus de sortie.

Syntaxe

myObject.exitStatus();

Renvoie

readError

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

Syntaxe

myObject.readError();

Renvoie

read

Renvoie le contenu de la sortie standard en un RawData .

Syntaxe

myObject.read();

Renvoie

readErrorText

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

Syntaxe

myObject.readErrorText();
myObject.readErrorText(encoding);

Arguments

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

Renvoie

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

readText

Renvoie le contenu standard de sortie sous forme de texte.

Syntaxe

myObject.readText();
myObject.readText(encoding);

Arguments

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

Renvoie

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

atEnd

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

Syntaxe

myObject.atEnd();

Returns

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

bytesAvailable

Renvoi le nombre de bytes qui peuvent être lus.

Syntaxe

myObject.bytesAvailable();

Renvoie

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

bytesToWrite

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

Syntaxe

myObject.bytesToWrite();

Renvoie

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

canReadLine

Renvoie vrai si une ligne peut être lue.

Syntaxe

myObject.canReadLine();

Renvoie

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

write

Écrit des données sur le processus.

Syntaxe

myObject.write(data);

Arguments

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

Renvoie

  • (Process) ce Processus

writeText

Écrit du texte sur le processus.

Syntaxe

myObject.writeText(text, encoding);

Arguments

  1. text - (string) le texte à écrire
  2. encoding - (Encoding) l'encodage à utiliser

Renvoie

  • (Process) ce Processus

setWorkingDirectory

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

Syntaxe

myObject.setWorkingDirectory(workingDirectory);

Arguments

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

Renvoie

  • (Process) ce Processus

setProcessChannelMode

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

Syntaxe

myObject.setProcessChannelMode(channelMode);

Arguments

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

Renvoie

  • (Process) ce Processus

setEnvironment

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

Syntaxe

myObject.setEnvironment(environment);

Arguments

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

Renvoie

  • (Process) ce Processus

Example

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

updateEnvironment

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

Syntaxe

myObject.updateEnvironment(environment);

Arguments

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

Returns

  • (Process) ce Processus

Example

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

setReadChannel

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

Syntaxe

myObject.setReadChannel(channel);

Arguments

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

Renvoie

  • (Process) ce Processus

setStandardErrorFile

Définit le fichier d'erreur standard.

Syntaxe

myObject.setStandardErrorFile(fileName);
myObject.setStandardErrorFile(fileName, openMode);

Arguments

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

Renvoie

  • (Process) ce Processus

setStandardInputFile

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

Syntaxe

myObject.setStandardInputFile(fileName);

Arguments

  1. fileName - (string) le nom du fichier

Renvoie

  • (Process) ce Processus

setStandardOutputFile

Définit le fichier de sortie standard.

Syntaxe

myObject.setStandardOutputFile(fileName);
myObject.setStandardOutputFile(fileName, openMode);

Arguments

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

Renvoie

  • (Process) ce Processus

setStandardOutputProcess

Définit la sortie standard du processus.

Syntaxe

myObject.setStandardOutputFile(process);

Arguments

  1. process - (Process) la sortie du processus

Renvoie

  • (Process) ce Processus

Exceptions

  • (InvalidProcessError) processus non valide

waitForFinished

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

Syntaxe

myObject.waitForFinished(waitTime);
myObject.waitForFinished();

Arguments

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

Renvoie

  • (Process) ce Processus

Exceptions

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

waitForStarted

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

Syntaxe

myObject.waitForStarted(waitTime);
myObject.waitForStarted();

Arguments

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

Renvoie

  • (Process) ce Processus

Exceptions

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

waitForBytesWritten

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

Syntaxe

myObject.waitForBytesWritten(waitTime);
myObject.waitForBytesWritten();

Arguments

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

Renvoie

  • (Process) ce Processus

Exceptions

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

waitForReadyRead

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

Syntaxe

myObject.waitForReadyRead(waitTime);
myObject.waitForReadyRead();

Arguments

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

Renvoie

  • (Process) ce Processus

Exceptions

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

close

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

Syntaxe

myObject.close();

Renvoie

  • (Process) ce Processus

kill

Kill (me baby!) le processus.

Syntaxe

myObject.kill();

Renvoie

  • (Process) ce Processus

terminate

Met fin au processus.

Syntaxe

myObject.terminate();

Renvoie

  • (Process) ce Processus

Évènements

onError

Appelé quand une erreur survient.

Syntaxe

myObject.onError = function(processError) {};

Arguments

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

Example

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

onFinished

Appelé quand le processus s'est terminé.

Syntaxe

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

Arguments

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

Example

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.

Syntaxe

myObject.onReadyReadStandardError = function() {};

Example

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

onReadyReadStandardOutput

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

Syntaxe

myObject.onReadyReadStandardOutput = function() {};

Example

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

onStarted

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

Syntaxe

myObject.onStarted = function() {};

Example

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

onStateChanged

Appelé quans le statut du processus a changé.

Syntaxe

myObject.onStateChanged = function(newState) {};

Arguments

  1. newState - (ProcessState) le ratio du processus

Example

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

Enumerations

ProcessError

Une erreur de processus.

Valeurs

  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

ExitStatus

Le statut de sortie.

Valeurs

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

ProcessState

Le statut du processus.

Valeurs

  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

ProcessChannel

Un "channel" de processus.

Valeurss

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

ProcessChannelMode

Un mode de "channel" de processus.

Valeurs

  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

OpenMode

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

Valeurs

  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
fr/code/system/process.txt · Dernière modification : 2021/02/13 11:23 de 127.0.0.1