Outils pour utilisateurs

Outils du site


fr:code:data:web

Web [En cours de Traduction Wismerheal][WSL]

Cet objet vous permet de télécharger des données.

Fonctions

Web

Fonction de construction.

Syntaxe

var myObject = new Web(eventsAndOptions);

Arguments

  1. eventsAndOptions - (object) l'évènement qui peut être appelé
    • onFinished - (onFinished) cappelé quand les données sont téléchargées
    • onDownloadProgress - (onDownloadProgress) appelé quand le téléchargement en cours progresse
    • onError - (onError) appelé quand une erreur survient
    • file - (File or string) le fichier ou nom de fichier à utiliser comme destination pour le téléchargement de données, si ce n'est pas définit les données seront stockées dans la RAM

Example

var myObject = new Web();
var myObject = new Web({
	onFinished: function()
	{
		Console.print("Finished!");
	},
	file: "myFile.txt"
});

Méthodes

download

Débute le téléchargement.

Syntaxe

myObject.download(url, options);
myObject.download(url);

Arguments

  1. url - (string) l'url de la ressources à télécharger
  2. options - (object) options
    • rawHeaders - (object) suite d'entête à définir
    • method - (Method) la méthode à utiliser ("get" ou "post")
    • postData - (object) "post" les données à envoyées
    • query - (object) acquisition d'élément
    • user - (string) le nom d'utilisateur à utilisé si demandé
    • password - (string) le mot de passe à utilisé si demandé

Renvoie

  • (Web) ce Web

Exceptions

  • (OpenFileError) impossible d'ouvrir le fichier de destination

Notes

Cette méthode est asynchrone, cela signifie que le renvoi s'effectue avant que les données ne soient téléchargées. Pour savoir quand le téléchargement est terminé, utilisez l'évènement onFinished ou la méthode isDownloading .

isDownloading

Renvoie vrai si les données sont toujours en cours de téléchargement.

Syntaxe

myObject.isDownloading();

Renvoie

  • (boolean) vrai si les données sont toujours en cours de téléchargement

toImage

Renvoie les données téléchargée comme un Image .

Syntaxe

myObject.toImage();

REnvoie

Notes

Vous ne pouvez pas utiliser cette méthode si le chemin de destination du fichier ne dispose pas de données car aucune donnée ne sera conservée en mémoire.

toText

Renvoie les données téléchargée comme un texte.

Syntaxe

myObject.toText(encoding);
myObject.toText();

Arguments

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

Renvoie

  • (string) le texte

Notes

Vous ne pouvez pas utiliser cette méthode si le chemin de destination du fichier ne dispose pas de données car aucune donnée ne sera conservée en mémoire.

toRawData

Renvoie les données téléchargées comme une RawData .

Syntaxe

myObject.toRawData();

Renvoie

Notes

Vous ne pouvez pas utiliser cette méthode si le chemin de destination du fichier ne dispose pas de données car aucune donnée ne sera conservée en mémoire.

cancel

Annule le téléchargement.

Syntaxe

myObject.cancel();

Renvoie

  • (Web) ce Web

Évènements

onFinished

Appelé quahd les données sont téléchargées.

Syntaxe

myObject.onFinished = function() {};

Example

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

onDownloadProgress

Appelé quand la progression du téléchargement a changé.

Syntaxe

myObject.onDownloadProgress = function(bytesReceived, bytesTotal) {};

Arguments

  1. bytesReceived - (integer) reçoit le compte de byte
  2. bytesTotal - (integer) compte total de byte

Example

myObject.onDownloadProgress = function(bytesReceived, bytesTotal)
{
	//Event action
};

onError

Appelé quand une erreur survient.

Syntaxe

myObject.onError = function(errorText) {};

Arguments

  1. errorText - (string) un texte décrivant l'erreur

Example

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

Enumerations

Méthode

La méthode de téléchargement.

Valeurs

  1. Get: utilisez la méthode "get" (défaut)
  2. Post: utilisez la méthode "post"
fr/code/data/web.txt · Dernière modification : 2021/02/13 11:23 de 127.0.0.1