Cette traduction est incomplète. Aidez à traduire cet article depuis l'anglais.
Non standard
Cette fonctionnalité n'est ni standard, ni en voie de standardisation. Ne l'utilisez pas pour des sites accessibles sur le Web : elle ne fonctionnera pas pour tout utilisateur. Il peut également y avoir d'importantes incompatibilités entre les implémentations et son comportement peut être modifié dans le futur.
L'API fichier système simule un fichier système en local que les applications web peuvent utiliser. Vous pouvez développer des applications qui lisent, écrivent, et créent des fichiers et/ou des dossiers dans un espace virtuel.
Deux API très simulaires existent en fonction du comportement asynchrone ou synchrone souhaité. L'API synchrone est prévu pour être utilisée dans un Worker
et retournera les valeurs recherchées. The asynchronous API will not block and functions and the API will not return values; instead, you will need to supply a callback function to handle the response whenever it arrives.
API asynchrone
L'API asynchrone a les interfaces suivantes :
- LocalFileSystem a deux méthodes globales qui vous permet d'avoir accès à un espace virtuel : requestFileSystem() et resolveLocalFileSystemURL(). Les méthodes sont implémentées par l'objet window et le worker global scope.
- FileSystem représente un fichier système. L'objet est la passerelle à votre API toute entière.
- Entry représente une entrée dans un fichier système. L'entrée peut être un fichier ou un dossier.
- DirectoryEntry représente un dossier dans un fichier système.
- DirectoryReader vous permet la lecture de fichiers et dossiers à partir d'un dossier.
- FileEntry représente un fichier dans un fichier système.
- FileError est une erreur que vous pourriez rencontrer pendant l'utilisation des méthodes asynchrones.
API synchrone
L'API synchrone est utile avec les WebWorkers. Contrairement à l'API asynchrone, l'API synchrone n'utilise pas les callbacks parce que les méthodes de l'API retournent des valeurs.
- LocalFileSystemSync a deux méthodes globales qui vous permet d'avoir accès à un espace virtuel : requestFileSystemSync() et resolveLocalFileSystemSyncURL(). Les méthodes sont implémentées par l'objet worker.
- FileSystemSync représente un fichier système.
- EntrySync représente une entrée dans un fichier système. L'entrée peut être un fichier ou un dossier.
- DirectoryEntrySync représente un dossier dans un fichier système.
- DirectoryReaderSync vous permet la lecture de fichiers et dossiers à partir d'un dossier.
- FileEntrySync représente un fichier dans un fichier système.
- FileException est une erreur que vous pourriez rencontrer pendant l'utilisation des méthodes synchrones.
Compatibilité navigateur
Fonctionnalité | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
API asynchrone | 13 webkit | Pas de support | Pas de support | Pas de support | Pas de support |
API synchrone | 13 webkit | Pas de support | Pas de support | Pas de support | Pas de support |
Fonctionnalité | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Phone | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
API asynchrone | Pas de support | (Oui) webkit | Pas de support | Pas de support | Pas de support | Pas de support |
API synchrone | Pas de support | (Oui) webkit | Pas de support | Pas de support | Pas de support | Pas de support |
Voir aussi
- Particularité : File API: Directories and System SpecificationNOTE
- Commentaire Mozilla : Why no FileSystem API in Firefox?