Début avec l'API d'accès au système de fichiers

L'API d'accès au système de fichiers fournit aux développeurs Web un outil puissant pour interagir directement avec les fichiers locaux d'un utilisateur, permettant un accès en lecture et en écriture. Cela ouvre des possibilités passionnantes pour créer des applications Web sophistiquées, notamment les éditeurs de texte avancés, les IDE, les outils de manipulation d'images et les fonctionnalités d'importation / exportation améliorées, toutes dans le frontend du navigateur. Explorons comment commencer à utiliser cette API.

Accès aux fichiers: lecture et écriture

Un aspect critique de l'utilisation de l'API d'accès au système de fichiers est la sécurité. Tous les appels API doivent être initiés par un geste utilisateur dans un contexte sécurisé. Nous utiliserons un événement de clic dans les exemples ci-dessous.

Fichiers de lecture: fichier unique

La lecture d'un seul fichier est remarquablement concise:

 Let FileHandle;

document.QuerySelector (". pick-file"). onclick = async () => {
  [filehandle] = attendre window.showOpenFilePicker ();

  const file = wait filehandle.getFile ();
  const Content = wait file.text ();

  retourner le contenu;
};

En supposant un bouton HTML avec la classe "Pick-File", en cliquant sur ce bouton déclenche le sélecteur de fichiers via window.showOpenFilePicker() . La poignée du fichier sélectionné est stockée dans fileHandle . La fonction renvoie le contenu du fichier en tant que texte.

L'objet fileHandle fournit des propriétés comme kind ("Fichier" ou "répertoire") et name .

 // Exemple de sortie de console.log (filehandle)
FileSystemFileHandle {kind: 'file', nom: 'data.txt'}

fileHandle.getFile() récupère les détails du fichier (dernier horodatage modifié, nom, taille, type), et file.text() extrait le contenu du fichier.

Lire plusieurs fichiers

Pour lire plusieurs fichiers, passez un objet Options pour showOpenFilePicker() :

 LET FileHandles;
const Options = {multiple: true};

document.QuerySelector (". pick-file"). onclick = async () => {
  filehandles = attendre window.showopenfilepicker (options);

  // code pour traiter plusieurs fichiers (voir ci-dessous)
};

La propriété multiple (par défaut: false ) permet la sélection de fichiers multiples. D'autres options spécifient les types de fichiers acceptables. Par exemple, pour accepter uniquement les images JPEG:

 const Options = {
  Types: [{Description: "Images", accepter: {"image / jpeg": ".jpeg"}}],
  ExcludeAcceptalloption: vrai,
};

Traitement de plusieurs fichiers:

 const allcontent = attendre promesse.all (
  filehandles.map (async (filehandle) => {
    const file = wait filehandle.getFile ();
    const Content = wait file.text ();
    retourner le contenu;
  })
));

console.log (allcontent);

Écriture dans les fichiers: nouveau fichier

La création et l'écriture dans un nouveau fichier sont également simples:

 document.QuerySelector (". Save-File"). OnClick = async () => {
  const Options = {
    Types: [{Description: "Test Files", accepter: {"Text / Plain": [".txt"]}}],
  };

  const handle = attend window.showsaveFilePicker (options);
  const witchable = wait handle.CreateWritable ();

  AWAIT WITCHABLE.WRITE ("Hello World");
  Await witchable.close ();

  poignée de retour;
};

window.showSaveFilePicker() ouvre la boîte de dialogue Enregistrer le fichier. handle.createWritable() crée un flux écrivative, writable.write() écrit des données, et writable.close() finalise l'opération d'écriture.

Édition de fichiers existants

Pour modifier un fichier existant:

 Let FileHandle;

document.QuerySelector (". pick-file"). onclick = async () => {
  [filehandle] = attendre window.showOpenFilePicker ();

  const file = wait filehandle.getFile ();
  const witchable = wait filehandle.createwritable ();

  AWAIT WITCHABLE.WRITE ("Ceci est une nouvelle ligne"); // ajoute au fichier
  Await witchable.close ();
};

Cet exemple ajoute le texte; Pour écraser, écrivez tout le contenu souhaité.

Fonctionnalités avancées

L'API d'accès au système de fichiers prend également en charge la liste des répertoires et la suppression des fichiers / répertoires.

Annonce de répertoire

 document.QuerySelect
  const DirectoryHandle = Await Window.showDirectoryPicker ();

  Pour Await (Cons Entrée de DirectoryHandle.Values ​​()) {
    console.log (entrée.kind, entrée.name);
  }
};

window.showDirectoryPicker() sélectionne un répertoire et la boucle itera à travers ses entrées.

Suppression des fichiers et du répertoire

Suppression d'un fichier:

 document.QuerySelector (". pick-file"). onclick = async () => {
  const [filehandle] = attendre window.showopenfilepicker ();
  attendre filehandle.remove ();
};

Suppression d'un répertoire (récursivement):

 document.QuerySelector (". pick-folder"). onclick = async () => {
  const DirectoryHandle = Await Window.showDirectoryPicker ();
  Await DirectoryHandle.RemoveEntry ('data', {récursif: true});
};

Compatibilité du navigateur

L'API d'accès au système de fichiers bénéficie d'un large support entre les navigateurs modernes, mais vérifiez Caniuse.com pour les informations de compatibilité les plus récentes. Un remplissage de poney comme browser-fs-access peut combler les lacunes de compatibilité.

Ressources

• API d'accès au système de fichiers (spécification W3C)
• API d'accès au système de fichiers (MDN)
• Autres ressources pertinentes

Cette explication améliorée fournit un guide plus complet et structuré de l'API d'accès au système de fichiers. N'oubliez pas de remplacer les liens d'espace réservé par des liens réels vers la documentation pertinente.

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!