Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

Window : méthode requestFileSystem()

Obsolète

Évitez d'utiliser cette fonctionnalité dans de nouveaux projets. Cette fonctionnalité peut être candidate à la suppression des standards web ou des navigateurs.

Non standard: Cette fonctionnalité n'est pas standardisée. Nous déconseillons d'utiliser des fonctionnalités non standard en production, car leur prise en charge par les navigateurs est limitée, et elles peuvent être modifiées ou supprimées. Toutefois, elles peuvent constituer une alternative appropriée dans certains cas où aucune option standard n'existe.

La méthode non standard requestFileSystem() de l'interface Window est spécifique à Google Chrome et permet à un site web ou à une application d'accéder à un système de fichiers sandboxé pour son propre usage. Le FileSystem retourné est ensuite disponible pour une utilisation avec les autres API de système de fichiers.

Note : Cette méthode est préfixée par webkit dans tous les navigateurs qui l'implémentent.

Syntaxe

js
requestFileSystem(type, size, successCallback)
requestFileSystem(type, size, successCallback, errorCallback)

Paramètres

type

Le type de stockage à demander. Définissez Window.TEMPORARY si le navigateur peut supprimer les fichiers à sa discrétion, par exemple si l'espace de stockage est faible, ou Window.PERSISTENT si vous avez besoin que les fichiers restent en place sauf si l'utilisateur·ice ou le site web ou l'application l'autorise explicitement. Le stockage persistant nécessite que l'utilisateur·ice accorde un quota au site.

size

La quantité d'espace de stockage que vous souhaitez allouer pour l'utilisation de votre application.

successCallback

Une fonction qui est invoquée lorsque le système de fichiers a été obtenu avec succès. La fonction de rappel reçoit un seul paramètre : un objet FileSystem représentant le système de fichiers que l'application est autorisée à utiliser.

errorCallback Facultatif

Un paramètre optionnel définissant une fonction qui est appelée si une erreur se produit lors de la tentative d'obtention du système de fichiers, ou si l'utilisateur·ice refuse l'autorisation de créer ou d'accéder au système de fichiers. La fonction de rappel reçoit en entrée un seul paramètre : un objet DOMException décrivant l'erreur.

Valeur de retour

Aucune (undefined).

Spécifications

Comme cette méthode a été supprimée de la proposition de l'API d'entrées de fichiers et de répertoires, elle n'a pas de spécification officielle W3C ou WHATWG. Elle n'est plus en voie de devenir une norme.

Compatibilité des navigateurs