diff options
Diffstat (limited to 'files/fr/web/api/localfilesystem/index.html')
| -rw-r--r-- | files/fr/web/api/localfilesystem/index.html | 46 |
1 files changed, 21 insertions, 25 deletions
diff --git a/files/fr/web/api/localfilesystem/index.html b/files/fr/web/api/localfilesystem/index.html index d8d3b0dd9c..9f4ca0c7c3 100644 --- a/files/fr/web/api/localfilesystem/index.html +++ b/files/fr/web/api/localfilesystem/index.html @@ -5,15 +5,15 @@ translation_of: Web/API/LocalFileSystem --- <div>{{APIRef("File System API")}}{{non-standard_header()}}</div> -<p>L'interface <code>LocalFileSystem</code>, appartenant à l'API <a href="/fr/docs/Web/API/File_and_Directory_Entries_API/Introduction" title="en/DOM/File_API/File_System_APIB">File System</a> fournit un accès à un système de fichier placé dans un bac à sable (<em>sandboxed file system</em>). Les méthodes de cette interface sont implémentées par les objets implémentants <code><a href="/fr/docs/Web/API/Window" title="cn/DOM/window">Window</a></code> ou <code><a href="/fr/docs/Web/API/Worker" title="En/DOM/Worker">Worker</a></code>.</p> +<p>L'interface <code>LocalFileSystem</code>, appartenant à l'API <a href="/fr/docs/Web/API/File_and_Directory_Entries_API/Introduction">File System</a> fournit un accès à un système de fichier placé dans un bac à sable (<em>sandboxed file system</em>). Les méthodes de cette interface sont implémentées par les objets implémentants <code><a href="/fr/docs/Web/API/Window">Window</a></code> ou <code><a href="/fr/docs/Web/API/Worker">Worker</a></code>.</p> <h2 id="Concepts_de_base">Concepts de base</h2> <h3 id="Créer_un_nouvel_espace_de_stockage">Créer un nouvel espace de stockage</h3> -<p>Il est possible de demander l'accès à un système de fichier dans un bac à sable en utilisant la méthode <code>window.requestFileSystem()</code>. Lorsque la création de cet espace est effectuée, une fonction de rappel (<em>callback</em>) est appelée avec un objet <code><a href="/fr/docs/Web/API/FileSystem" title="en/DOM/File_API/File_System_API/FileSystem">FileSystem</a></code> contenant deux propriétés : le nom et la racine du système de fichier ainsi créé.</p> +<p>Il est possible de demander l'accès à un système de fichier dans un bac à sable en utilisant la méthode <code>window.requestFileSystem()</code>. Lorsque la création de cet espace est effectuée, une fonction de rappel (<em>callback</em>) est appelée avec un objet <code><a href="/fr/docs/Web/API/FileSystem">FileSystem</a></code> contenant deux propriétés : le nom et la racine du système de fichier ainsi créé.</p> -<p>Il est possible d'appeler cette méthode plusieurs fois pour différentes situations : on peut créer un espace de stockage temporaire et/ou un espace de stockage permanent (voir <a href="/fr/docs/Web/API/File_and_Directory_Entries_API/Introduction" title="https://developer.mozilla.org/en/DOM/File_APIs/Filesystem/Basic_Concepts_About_the_Filesystem_API#The_File_System_API_can_use_different_storage_types">l'article sur les concepts de base</a> pour approfondir). On peut ainsi créer un espace de stockage temporaire pour mettre en cache certains fichiers (des images par exemple) afin d'améliorer les performances ou créer un espace de stockage pour des données applicatives (ex. des brouillons de messages créés par l'utilisateur) qui ne devraient pas être supprimées avant d'être répliquées sur les serveurs distants.</p> +<p>Il est possible d'appeler cette méthode plusieurs fois pour différentes situations : on peut créer un espace de stockage temporaire et/ou un espace de stockage permanent (voir <a href="/fr/docs/Web/API/File_and_Directory_Entries_API/Introduction">l'article sur les concepts de base</a> pour approfondir). On peut ainsi créer un espace de stockage temporaire pour mettre en cache certains fichiers (des images par exemple) afin d'améliorer les performances ou créer un espace de stockage pour des données applicatives (ex. des brouillons de messages créés par l'utilisateur) qui ne devraient pas être supprimées avant d'être répliquées sur les serveurs distants.</p> <h3 id="Utiliser_un_stockage_persistent">Utiliser un stockage persistent</h3> @@ -37,13 +37,13 @@ navigator.webkitPersistentStorage.requestQuota ( <h3 id="Origine_unique">Origine unique</h3> -<p>Le système de fichier est accessible depuis une seule origine. Cela signifie que votre application ne peut pas lire ou écrire des fichiers dans les systèmes de fichier éventuellement créés par d'autres applications. Par ailleurs, votre application ne peut pas accéder aux fichiers d'un répertoire arbitraire (ex. Mes Images, Mes Documents) sur le disque de l'utilisateur. Pour plus d'informations, voir <a href="/fr/docs/Web/API/File_and_Directory_Entries_API/Introduction" title="https://developer.mozilla.org/en/DOM/File_APIs/Filesystem/Basic_Concepts_About_the_Filesystem_API#Restrictions">l'article d'introduction aux concepts de base</a>.</p> +<p>Le système de fichier est accessible depuis une seule origine. Cela signifie que votre application ne peut pas lire ou écrire des fichiers dans les systèmes de fichier éventuellement créés par d'autres applications. Par ailleurs, votre application ne peut pas accéder aux fichiers d'un répertoire arbitraire (ex. Mes Images, Mes Documents) sur le disque de l'utilisateur. Pour plus d'informations, voir <a href="/fr/docs/Web/API/File_and_Directory_Entries_API/Introduction">l'article d'introduction aux concepts de base</a>.</p> <h3 id="Exemple">Exemple</h3> <p>Voici un fragment de code qui illustre comment demander l'accès à un stockage sur le système de fichier.</p> -<pre class="brush: js notranslate">// Gestion des préfixes spécifiques au navigateur +<pre class="brush: js">// Gestion des préfixes spécifiques au navigateur window.requestFileSystem = window.requestFileSystem || window.webkitRequestFileSystem; // Le premier paramètre indique le type de stockage @@ -80,7 +80,7 @@ window.requestFileSystem(window.PERSISTENT, 1024*1024,onInitFs,errorHandler); <h2 id="Méthodes">Méthodes</h2> -<h3 id="requestFileSystem" name="requestFileSystem"><code>requestFileSystem()</code></h3> +<h3 id="requestFileSystem"><code>requestFileSystem()</code></h3> <p>Cette méthode permet de demander l'accès à uyn système de fichier pour stocker des données. On peut ainsi accéder à un système de fichier placé dans un bac à sable en demandant un objet <code>LocalFileSystem</code> avec la méthode globale <code>window.requestFileSystem()</code>.</p> @@ -91,7 +91,7 @@ window.requestFileSystem(window.PERSISTENT, 1024*1024,onInitFs,errorHandler); in ErrorCallback errorCallback );</pre> -<h5 id="Paramètres">Paramètres</h5> +<h4 id="Paramètres">Paramètres</h4> <dl> <dt><code>type</code></dt> @@ -99,7 +99,7 @@ window.requestFileSystem(window.PERSISTENT, 1024*1024,onInitFs,errorHandler); <dt><code>size</code></dt> <dd>L'espace de stockage, exprimé en octets, nécessaire à l'application.</dd> <dt><code>successCallback</code></dt> - <dd>Une fonction de rappel à invoquer lorsque le navigateur fournit bien l'accès au système de fichier. Cette fonction reçoit en argument un objet <code><a href="/fr/docs/Web/API/FileSystem" title="en/DOM/File_API/File_System_API/FileSystem">FileSystem</a></code> avec deux propriétés : + <dd>Une fonction de rappel à invoquer lorsque le navigateur fournit bien l'accès au système de fichier. Cette fonction reçoit en argument un objet <code><a href="/fr/docs/Web/API/FileSystem">FileSystem</a></code> avec deux propriétés : <ul> <li><code>name</code> - le nom unique, assigné par le navigateur au système de fichiers.</li> <li><code>root</code> - un objet <code>DirectoryEntry</code> en lecture seule qui représente la racine du système de fichier.</li> @@ -109,15 +109,13 @@ window.requestFileSystem(window.PERSISTENT, 1024*1024,onInitFs,errorHandler); <dd>Une fonction de rappel à invoquer en cas d'erreur ou lorsque l'accès n'est pas autorisé. Cette fonction reçoit un objet <code>FileError</code> comme argument.</dd> </dl> -<h5 id="Valeur_de_retour">Valeur de retour</h5> +<h4 id="Valeur_de_retour">Valeur de retour</h4> -<dl> - <dt><code>void</code></dt> -</dl> +<p><code>void</code></p> -<h5 id="Exceptions">Exceptions</h5> +<h4 id="Exceptions">Exceptions</h4> -<p>Cette méthode peut lever une exception <code><a href="/en-US/docs/Web/API/FileError" title="en/DOM/File_API/File_System_API/FileException">FileError</a></code> avec le code suivant :</p> +<p>Cette méthode peut lever une exception <code><a href="/en-US/docs/Web/API/FileError">FileError</a></code> avec le code suivant :</p> <table class="standard-table"> <thead> @@ -127,12 +125,12 @@ window.requestFileSystem(window.PERSISTENT, 1024*1024,onInitFs,errorHandler); </tr> <tr> <td><code>SECURITY_ERROR</code></td> - <td>L'application n'est pas autorisée à accéder à l'interface <em>File System</em>. Par exemple, il est interdit d'utiliser <code>file://</code>. Pour plus de détails, consulter <a href="/fr/docs/Web/API/File_and_Directory_Entries_API/Introduction#restrictions" title="https://developer.mozilla.org/en/DOM/File_APIs/Filesystem/Basic_Concepts_About_the_Filesystem_API#You_cannot_run_your_app_from_file:.2F.2F">l'article d'introduction aux concepts de base</a>.</td> + <td>L'application n'est pas autorisée à accéder à l'interface <em>File System</em>. Par exemple, il est interdit d'utiliser <code>file://</code>. Pour plus de détails, consulter <a href="/fr/docs/Web/API/File_and_Directory_Entries_API/Introduction#restrictions">l'article d'introduction aux concepts de base</a>.</td> </tr> </thead> </table> -<h3 id="resolveLocalFileSystemURL" name="resolveLocalFileSystemURL()"><code>resolveLocalFileSystemURL()</code></h3> +<h3 id="resolveLocalFileSystemURL"><code>resolveLocalFileSystemURL()</code></h3> <p>Cette méthode permet de consulter une entrée pour un fichier ou un répertoire avec une URL locale.</p> @@ -143,7 +141,7 @@ window.requestFileSystem(window.PERSISTENT, 1024*1024,onInitFs,errorHandler); ); </pre> -<h5 id="Paramètres_2">Paramètres</h5> +<h4 id="Paramètres_2">Paramètres</h4> <dl> <dt><code>url</code></dt> @@ -154,15 +152,13 @@ window.requestFileSystem(window.PERSISTENT, 1024*1024,onInitFs,errorHandler); <dd>Une fonction de rappel à invoquer en cas d'erreur ou lorsque l'accès est refusé.</dd> </dl> -<h5 id="Valeur_de_retour_2">Valeur de retour</h5> +<h4 id="Valeur_de_retour_2">Valeur de retour</h4> -<dl> - <dt><code>void</code></dt> -</dl> +<p>void</p> -<h5 id="Exceptions_2">Exceptions</h5> +<h4 id="Exceptions_2">Exceptions</h4> -<p>Cette méthode peut lever une exception <code><a href="/fr/docs/Web/API/FileError" title="en/DOM/File_API/File_System_API/FileException">FileError</a></code> avec l'un des code suivants :</p> +<p>Cette méthode peut lever une exception <code><a href="/fr/docs/Web/API/FileError">FileError</a></code> avec l'un des code suivants :</p> <table class="standard-table"> <thead> @@ -195,6 +191,6 @@ window.requestFileSystem(window.PERSISTENT, 1024*1024,onInitFs,errorHandler); <ul> <li>La spécification : {{spec("http://dev.w3.org/2009/dap/file-system/pub/FileSystem/", "File API: Directories and System Specification", "WD")}}</li> - <li><a href="/fr/docs/Web/API/File_and_Directory_Entries_API/Introduction" title="en/DOM/File_API/File_System_API">La référence pour l'API <em>File System</em></a></li> - <li><a href="/fr/docs/Web/API/File_and_Directory_Entries_API/Introduction" title="en/DOM/File_APIs/Filesystem/Basic_Concepts_About_the_Filesystem_API">Une introduction aux concepts de base de l'API <em>File System</em></a></li> + <li><a href="/fr/docs/Web/API/File_and_Directory_Entries_API/Introduction">La référence pour l'API <em>File System</em></a></li> + <li><a href="/fr/docs/Web/API/File_and_Directory_Entries_API/Introduction">Une introduction aux concepts de base de l'API <em>File System</em></a></li> </ul> |