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
requestFileSystem(type, size, successCallback)
requestFileSystem(type, size, successCallback, errorCallback)
Paramètres
type-
Le type de stockage à demander. Définissez
Window.TEMPORARYsi le navigateur peut supprimer les fichiers à sa discrétion, par exemple si l'espace de stockage est faible, ouWindow.PERSISTENTsi 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
FileSystemreprésentant le système de fichiers que l'application est autorisée à utiliser. errorCallbackFacultatif-
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
DOMExceptiondé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.