Aller directement au contenu

@capgo/capacitor-fichier

Capacitor Plugin de fichier 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 - Obtenez une entrée de fichier.
  • getDirectory - Obtenez une entrée de répertoire.
MéthodeDescription
requestFileSystemDemande un système de fichiers.
resolveLocalFileSystemURLRésolvez une URL de fichier en entrée.
getFileObtenez une entrée de fichier.
getDirectoryObtenez 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 de type 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.
readdirLire les contenus d'un répertoire.
statObtenir les métadonnées sur un fichier ou un répertoire.
getMetadataObtenir les 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.
getUriObtenir l'URI d'un fichier.
truncateTronquer un fichier jusqu'à une taille spécifiée.
getDirectoriesObtenir tous les répertoires du système de fichiers connus.
getFreeDiskSpaceObtenir l'espace disque libre en octets.
addListenerÉcouter les événements de progression de lecture.
addListenerÉcouter les événements de progression d'écriture.
removeAllListenersSupprimer tous les écouteurs d'événements.
getPluginVersionObtenir la version du plugin.
checkPermissionsVérifier l'état actuel des permissions 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.
requestPermissionsDemander 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 de la sélection d'un emplacement de stockage, de l'écriture de texte codé ou de la gestion d'erreurs de fichiers.

ValeurLes utilisateurs trouveront
DOCUMENTSDocuments persistants visibles par l'utilisateur. Sur Android, cela correspond au répertoire des fichiers de l'application.
DATADonnées privées de l'application persistantes.
LIBRARYDonnées d'application persistantes non 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.
EXTERNALRacine de stockage externe Android, comme une carte SD ou un stockage externe partagé.
EXTERNAL_STORAGERépertoire de données de stockage externe Android.
APPLICATIONRépertoire du bundle ou des assets de l'application en lecture seule.
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_ERR8Le chemin ou la syntaxe d'entrée est invalide.
INVALID_MODIFICATION_ERR9La modification demandée est invalide pour la cible.
QUOTA_EXCEEDED_ERR10Le quota de stockage a été dépassé.
TYPE_MISMATCH_ERR11Type de valeur ne correspond pas au type attendu.
PATH_EXISTS_ERR12Le chemin cible existe déjà.

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

Si vous utilisez @capgo/capacitor-fichier pour planifier le stockage et la gestion des fichiers, connectez-l’avec Utilisation de @capgo/capacitor-fichier pour la capacité native dans Utilisation de @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, Utilisation de @capgo/capacitor-stockage-de-données-sqlite pour la capacité native dans Utilisation de @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 Utilisation de @capgo/capacitor-téléchargeur pour la capacité native dans Utilisation de @capgo/capacitor-téléchargeur.