Window : méthode requestFileSystem()
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.
Obsolète: Cette fonctionnalité n'est plus recommandée. Même si certains navigateurs la prennent encore en charge, elle a peut-être déjà été supprimée des standards du web, est en passe d'être supprimée ou n'est conservée qu'à des fins de compatibilité. Évitez de l'utiliser et mettez à jour le code existant si possible ; consultez le tableau de compatibilité au bas de cette page pour vous aider à prendre votre décision. Sachez que cette fonctionnalité peut cesser de fonctionner à tout moment.
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.