Sauter au contenu

@capgo/capacitor-fichier

Le plugin Capacitor implémente les opérations de système de fichiers similaires au plugin Cordova File.

Capacitor Implémente les opérations de système de fichiers similaires au plugin Cordova File.

  • requestFileSystem - Demande un système de fichiers.
  • resolveLocalFileSystemURL - Résolvez une URL de fichier en entrée.
  • getFile - Obtenir une entrée de fichier.
  • getDirectory - Obtenir une entrée de répertoire.
MéthodeDescription
requestFileSystemDemander un système de fichiers.
resolveLocalFileSystemURLRésoudre une URL de fichier en entrée.
getFileObtenir une entrée de fichier.
getDirectoryObtenir une entrée de répertoire.
readFileLire un fichier en texte ou en base64.
readAsDataURLLire un fichier sous forme de URL de données (base64 avec préfixe MIME).
writeFileÉcrire des données dans un fichier.
appendFileAjouter des données à un fichier.
deleteFileSupprimer un fichier.
mkdirCréer un répertoire.
rmdirSupprimer un répertoire.
readdirLister les contenus d'un répertoire.
statObtenir des métadonnées sur un fichier ou un répertoire.
getMetadataObtenir des métadonnées sur un fichier ou un répertoire. Alias pour stat().
renameRenommer ou déplacer un fichier ou un répertoire.
moveDéplacer un fichier ou un répertoire. Alias pour rename().
copyCopier un fichier ou un répertoire.
existsVérifier si un fichier ou un répertoire existe.
getUriObtenez l'URI d'un fichier.
truncateTronquez un fichier jusqu'à une taille spécifiée.
getDirectoriesObtenez tous les répertoires de système de fichiers connus.
getFreeDiskSpaceObtenez l'espace disque libre en octets.
addListenerÉcoutez les événements de progression de lecture.
addListenerÉcoutez les événements de progression d'écriture.
removeAllListenersSupprimez tous les écouteurs d'événements.
getPluginVersionObtenez la version du plugin.
checkPermissionsVérifiez l'état de permission actuel pour les opérations de fichiers. Sur Android, cela vérifie les permissions d'accès aux fichiers externes. Sur iOS et web, cela retourne toujours ‘accordé’ car aucune permission spéciale n'est nécessaire.
requestPermissionsDemandez les permissions pour les opérations de fichiers. Sur Android, cela demande les permissions d'accès aux fichiers externes nécessaires pour accéder aux fichiers en dehors des répertoires privés de l'application. Sur iOS et web, cela retourne toujours ‘accordé’ car aucune permission spéciale n'est nécessaire.

Utilisez ces valeurs lors du choix d'un emplacement de stockage, de l'écriture de texte codé ou de la gestion d'erreurs de fichiers.

ValeurL'utilisateur trouvera
DOCUMENTSDocuments persistants visibles par l'utilisateur. Sur Android, cela correspond au répertoire des fichiers de l'application.
DATADonnées d'application privées persistantes.
LIBRARYDonnées d'application persistantes qui ne sont pas visibles par l'utilisateur. Sur Android, cela correspond au répertoire des fichiers de l'application.
CACHEDonnées de cache temporaires que le système peut effacer.
EXTERNALEmplacement de stockage externe Android, tel qu'une carte SD ou un stockage externe partagé.
EXTERNAL_STORAGERépertoire de données de stockage externe Android.
APPLICATIONRépertoire du bundle d'application ou des ressources non modifiables.
ValeurUtilisation
utf8Texte UTF-8.
asciiTexte ASCII.
utf16Texte UTF-16.
ValeurCodeSignification
NOT_FOUND_ERR1Le fichier ou le répertoire n'a pas été trouvé.
SECURITY_ERR2L'opération a été bloquée par les règles de sécurité ou les permissions.
ABORT_ERR3L'opération a été annulée.
NOT_READABLE_ERR4Le fichier ou le répertoire ne peut pas être lu.
ENCODING_ERR5Le codage est invalide ou non pris en charge.
NO_MODIFICATION_ALLOWED_ERR6La cible ne peut pas être modifiée.
INVALID_STATE_ERR7L'objet est dans un état non valide pour l'opération.
SYNTAX_ERR8La voie ou la syntaxe d'entrée est invalide.
INVALID_MODIFICATION_ERR9La modification demandée est invalide pour la cible.
QUOTA_EXCEEDED_ERR10La limite de stockage a été dépassée.
TYPE_MISMATCH_ERR11Le type de valeur ne correspond pas au type attendu.
PATH_EXISTS_ERR12La cible du chemin existe déjà.

Cette référence est synchronisée à partir de src/definitions.ts en capacitor-fichier.

Si vous utilisez @capgo/capacitor-fichier pour planifier le stockage et la gestion des fichiers, connectez-le avec En utilisant @capgo/capacitor-fichier pour la capacité native dans En utilisant @capgo/capacitor-fichier, @capgo/capacitor-stockage-de-données-sqlite pour le détail d'implémentation dans @capgo/capacitor-stockage-de-données-sqlite, En utilisant @capgo/capacitor-stockage-de-données-sqlite pour la capacité native dans En utilisant @capgo/capacitor-stockage-de-données-sqlite, @capgo/capacitor-téléchargeur pour le détail d'implémentation dans @capgo/capacitor-téléchargeur, et En utilisant @capgo/capacitor-téléchargeur pour la capacité native dans En utilisant @capgo/capacitor-téléchargeur.