Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

fix: flaws in web/api/f* batch 2 #3045

Merged
merged 1 commit into from
Mar 15, 2021
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 7 additions & 7 deletions files/en-us/web/api/filesystemdirectoryhandle/keys/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -2,12 +2,12 @@
title: FileSystemDirectoryHandle.keys()
slug: Web/API/FileSystemDirectoryHandle/keys
tags:
- Directories
- File System Access API
- FileSystemDirectoryHandle
- Files
- Iterable
- Method
- Directories
- File System Access API
- FileSystemDirectoryHandle
- Files
- Iterable
- Method
---
<div>{{draft}}{{securecontext_header}}{{DefaultAPISidebar("File System Access API")}}
</div>
Expand Down Expand Up @@ -57,7 +57,7 @@ <h2 id="Browser_compatibility">Browser compatibility</h2>
<h2 id="See_also">See also</h2>

<ul>
<li><a href="/docs/Web/API/File_System_Access_API">File System Access API</a></li>
<li><a href="/en-US/docs/Web/API/File_System_Access_API">File System Access API</a></li>
<li><a href="https://web.dev/file-system-access/">The File System Access API:
simplifying access to local files</a></li>
</ul>
Original file line number Diff line number Diff line change
Expand Up @@ -2,11 +2,11 @@
title: FileSystemDirectoryHandle.removeEntry()
slug: Web/API/FileSystemDirectoryHandle/removeEntry
tags:
- Directory
- File
- File System Access API
- FileSystemDirectoryHandle
- Method
- Directory
- File
- File System Access API
- FileSystemDirectoryHandle
- Method
---
<div>{{draft}}{{securecontext_header}}{{DefaultAPISidebar("File System Access API")}}
</div>
Expand Down Expand Up @@ -90,7 +90,7 @@ <h2 id="Browser_compatibility">Browser compatibility</h2>
<h2 id="See_also">See also</h2>

<ul>
<li><a href="/docs/Web/API/File_System_Access_API">File System Access API</a></li>
<li><a href="/en-US/docs/Web/API/File_System_Access_API">File System Access API</a></li>
<li><a href="https://web.dev/file-system-access/">The File System Access API:
simplifying access to local files</a></li>
</ul>
Original file line number Diff line number Diff line change
Expand Up @@ -2,11 +2,11 @@
title: FileSystemDirectoryHandle.resolve()
slug: Web/API/FileSystemDirectoryHandle/resolve
tags:
- Directory
- File
- File System Access API
- FileSystemDirectoryHandle
- Method
- Directory
- File
- File System Access API
- FileSystemDirectoryHandle
- Method
---
<div>{{draft}}{{securecontext_header}}{{DefaultAPISidebar("File System Access API")}}
</div>
Expand Down Expand Up @@ -93,7 +93,7 @@ <h2 id="Browser_compatibility">Browser compatibility</h2>
<h2 id="See_also">See also</h2>

<ul>
<li><a href="/docs/Web/API/File_System_Access_API">File System Access API</a></li>
<li><a href="/en-US/docs/Web/API/File_System_Access_API">File System Access API</a></li>
<li><a href="https://web.dev/file-system-access/">The File System Access API:
simplifying access to local files</a></li>
</ul>
Original file line number Diff line number Diff line change
Expand Up @@ -2,12 +2,12 @@
title: FileSystemDirectoryHandle.values()
slug: Web/API/FileSystemDirectoryHandle/values
tags:
- Directory
- File
- File System Access API
- FileSystemDirectoryHandle
- Iterable
- Method
- Directory
- File
- File System Access API
- FileSystemDirectoryHandle
- Iterable
- Method
---
<div>{{draft}}{{securecontext_header}}{{DefaultAPISidebar("File System Access API")}}
</div>
Expand Down Expand Up @@ -58,7 +58,7 @@ <h2 id="Browser_compatibility">Browser compatibility</h2>
<h2 id="See_also">See also</h2>

<ul>
<li><a href="/docs/Web/API/File_System_Access_API">File System Access API</a></li>
<li><a href="/en-US/docs/Web/API/File_System_Access_API">File System Access API</a></li>
<li><a href="https://web.dev/file-system-access/">The File System Access API:
simplifying access to local files</a></li>
</ul>
2 changes: 1 addition & 1 deletion files/en-us/web/api/filesystementry/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@
---
<div>{{APIRef("File System API")}} {{non-standard_header}}</div>

<p>The <strong><code>FileSystemEntry</code></strong> interface of the File and Directory Entries API represents a single entry in a file system. The entry can be a file or a directory (directories are represented by the {{domxref("DirectoryEntry")}} interface). It includes methods for working with files—including copying, moving, removing, and reading files—as well as information about a file it points to—including the file name and its path from the root to the entry.</p>
<p>The <strong><code>FileSystemEntry</code></strong> interface of the File and Directory Entries API represents a single entry in a file system. The entry can be a file or a directory (directories are represented by the {{domxref("FileSystemDirectoryEntry")}} interface). It includes methods for working with files—including copying, moving, removing, and reading files—as well as information about a file it points to—including the file name and its path from the root to the entry.</p>

<div class="note">
<p>Because this is a non-standard API, whose specification is not currently on a standards track, it's important to keep in mind that not all browsers implement it, and those that do may implement only small portions of it. Check the {{anch("Browser compatibility")}} section for details.</p>
Expand Down
42 changes: 21 additions & 21 deletions files/en-us/web/api/filesystementrysync/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@
---
<div>{{APIRef("File System API")}}{{Non-standard_header()}}</div>

<p><span class="seoSummary">The <code>FileSystemEntrySync</code> interface of the File and Directory Entries API represents an entry in a file system; it can be either a {{domxref("FileEntrySync")}} or {{domxref("DirectoryEntry")}}.</span> It includes methods for working with files—including copying, moving, removing, and reading files—as well as information about the file it points to—including the file name and its path from the root to the entry.</p>
<p><span class="seoSummary">The <code>FileSystemEntrySync</code> interface of the File and Directory Entries API represents an entry in a file system; it can be either a {{domxref("FileEntrySync")}} or {{domxref("FileSystemDirectoryEntry")}}.</span> It includes methods for working with files—including copying, moving, removing, and reading files—as well as information about the file it points to—including the file name and its path from the root to the entry.</p>

<div class="warning">
<p><strong>Warning:</strong> This API was never accepted and never became standardized. Various browsers implement pieces of the <a href="/en-US/docs/Web/API/File_and_Directory_Entries_API">File and Directory Entries API</a> (otherwise known as the File System API) but you should try to avoid using it.</p>
Expand All @@ -33,19 +33,19 @@ <h2 id="Method_overview">Method overview</h2>
<table class="standard-table">
<tbody>
<tr>
<td><code>Metadata <a href="#getmetada">getMetadata</a> () raises (<a href="/en-US/docs/DOM/File_API/File_System_API/FileException">FileException</a>);</code></td>
<td><code>Metadata <a href="#getmetada">getMetadata</a> () raises (<a href="/en-US/docs/Web/API/FileException">FileException</a>);</code></td>
</tr>
<tr>
<td><code>FileSystemEntrySync <a href="#moveto">moveTo</a> (in <a href="/en-US/docs/DOM/File_API/File_System_API/DirectoryEntrySync">DirectoryEntrySync</a> <em>parent</em>, optional DOMString <em>newName</em>) raises (<a href="/en-US/docs/DOM/File_API/File_System_API/FileException">FileException</a>);</code></td>
<td><code>FileSystemEntrySync <a href="#moveto">moveTo</a> (in <a href="/en-US/docs/Web/API/DirectoryEntrySync">DirectoryEntrySync</a> <em>parent</em>, optional DOMString <em>newName</em>) raises (<a href="/en-US/docs/Web/API/FileException">FileException</a>);</code></td>
</tr>
<tr>
<td><code>FileSystemEntrySync <a href="#copyto">copyTo</a>(in <a href="/en-US/docs/DOM/File_API/File_System_API/DirectoryEntrySync">DirectoryEntrySync</a> <em>parent</em>, optional DOMString <em>newName</em>) raises (<a href="/en-US/docs/DOM/File_API/File_System_API/FileException">FileException</a>);</code></td>
<td><code>FileSystemEntrySync <a href="#copyto">copyTo</a>(in <a href="/en-US/docs/Web/API/DirectoryEntrySync">DirectoryEntrySync</a> <em>parent</em>, optional DOMString <em>newName</em>) raises (<a href="/en-US/docs/Web/API/FileException">FileException</a>);</code></td>
</tr>
<tr>
<td><code>DOMString <a href="#tourl">toURL</a>();</code></td>
</tr>
<tr>
<td><code>void <a href="#remove">remove</a>() raises (<a href="/en-US/docs/DOM/File_API/File_System_API/FileException">FileException</a>);</code></td>
<td><code>void <a href="#remove">remove</a>() raises (<a href="/en-US/docs/Web/API/FileException">FileException</a>);</code></td>
</tr>
<tr>
<td><code>DirectoryEntrySync <a href="#getparent">getParent</a>();</code></td>
Expand Down Expand Up @@ -103,7 +103,7 @@ <h3 id="getMetadata">getMetadata()</h3>
<p>Look up metadata about this entry. [ todo: specify what kind of metadata ]</p>

<pre>Metadata getMetada ()
raises <code>(<a href="https://developer.mozilla.org/en/DOM/File_API/File_System_API/FileException">FileException</a>)</code>;</pre>
raises <code>(<a href="/en-US/docs/Web/API/FileException">FileException</a>)</code>;</pre>

<h5 id="Parameter">Parameter</h5>

Expand All @@ -118,7 +118,7 @@ <h5 id="Returns">Returns</h5>

<h5 id="Exceptions">Exceptions</h5>

<p>This method can raise a <a href="/en-US/docs/DOM/File_API/File_System_API/FileException">FileException</a> with the following codes:</p>
<p>This method can raise a <a href="/en-US/docs/Web/API/FileException">FileException</a> with the following codes:</p>

<table class="standard-table">
<thead>
Expand Down Expand Up @@ -156,7 +156,7 @@ <h3 id="moveTo">moveTo()</h3>

<pre>FileSystemEntrySync moveTo (
in DirectoryEntrySync <em>parent</em>, optional DOMString <em>newName</em>
) raises (<a href="https://developer.mozilla.org/en/DOM/File_API/File_System_API/FileException">FileException</a>);</pre>
) raises (<a href="/en-US/docs/Web/API/FileException">FileException</a>);</pre>

<h5 id="Parameters">Parameters</h5>

Expand All @@ -176,7 +176,7 @@ <h5 id="Returns_2">Returns</h5>

<h5 id="Exceptions_2">Exceptions</h5>

<p>This method can raise a <a href="/en-US/docs/DOM/File_API/File_System_API/FileException">FileException</a> with the following codes:</p>
<p>This method can raise a <a href="/en-US/docs/Web/API/FileException">FileException</a> with the following codes:</p>

<table class="standard-table">
<thead>
Expand Down Expand Up @@ -218,7 +218,7 @@ <h3 id="copyTo">copyTo()</h3>

<pre>void copyTo (
in DirectoryEntrySync <em>parent</em>, optional DOMString <em>newName</em>
) raises (<a href="https://developer.mozilla.org/en/DOM/File_API/File_System_API/FileException">FileException</a>);</pre>
) raises (<a href="/en-US/docs/Web/API/FileException">FileException</a>);</pre>

<h5 id="Parameters_2">Parameters</h5>

Expand All @@ -238,7 +238,7 @@ <h5 id="Returns_3">Returns</h5>

<h5 id="Exceptions_3">Exceptions</h5>

<p>This method can raise a <a href="/en-US/docs/DOM/File_API/File_System_API/FileException">FileException</a> with the following codes:</p>
<p>This method can raise a <a href="/en-US/docs/Web/API/FileException">FileException</a> with the following codes:</p>

<table class="standard-table">
<thead>
Expand Down Expand Up @@ -273,14 +273,14 @@ <h5 id="Exceptions_3">Exceptions</h5>
</tr>
<tr>
<td><code>QUOTA_EXCEEDED_ERR</code></td>
<td>The operation would cause the application to exceed its storage quota. You can ask for a larger persistent storage, which your user must explicitly grant. For more information, see the article on <a href="/en-US/docs/DOM/File_APIs/Filesystem/Basic_Concepts_About_the_Filesystem_API" title="Basic Concepts About the Filesystem API">basic concepts</a>. </td>
<td>The operation would cause the application to exceed its storage quota. You can ask for a larger persistent storage, which your user must explicitly grant. For more information, see the article on <a href="/en-US/docs/Web/API/File_and_Directory_Entries_API/Introduction">basic concepts</a>. </td>
</tr>
</tbody>
</table>

<h3 id="toURL">toURL()</h3>

<p>Returns a URL that can be used to identify this entry. It exposes a new URL scheme—<code>filesystem:</code>—that you can use to fill <code>src</code> or <code>href </code>attributes. For example, if you wanted to display an image and have its <a href="/en-US/docs/DOM/File_API/File_System_API/FileEntry">fileEntry</a>, calling <code>toURL()</code> gives you the image file's file system URL. You get something like: <code>filesystem:<a href="http://example.com/temporary/lolcat.png">http://example.com/temporary/lolcat.png</a>.</code></p>
<p>Returns a URL that can be used to identify this entry. It exposes a new URL scheme—<code>filesystem:</code>—that you can use to fill <code>src</code> or <code>href </code>attributes. For example, if you wanted to display an image and have its <a href="/en-US/docs/Web/API/FileSystemFileEntry">fileEntry</a>, calling <code>toURL()</code> gives you the image file's file system URL. You get something like: <code>filesystem:<a href="http://example.com/temporary/lolcat.png">http://example.com/temporary/lolcat.png</a>.</code></p>

<p>The file system URL does not expire. Because the method describes a location on disk, the URL is valid for as long as that location exists. You can delete the file and recreate it, and it's all good. </p>

Expand All @@ -305,10 +305,10 @@ <h5 id="Exceptions_4">Exceptions</h5>

<h3 id="remove">remove()</h3>

<p>Deletes a file or directory. You cannot delete an empty directory or the root directory of a file system. If you want to remove an empty directory, use <a href="/en-US/docs/DOM/File_API/File_System_API/DirectoryEntrySync#removeRecursively()" rel="internal"><code>removeRecursively()</code></a> instead.</p>
<p>Deletes a file or directory. You cannot delete an empty directory or the root directory of a file system. If you want to remove an empty directory, use <a href="/en-US/docs/Web/API/DirectoryEntrySync#removerecursively()" rel="internal"><code>removeRecursively()</code></a> instead.</p>

<pre>void remove (
) raises (<a href="https://developer.mozilla.org/en/DOM/File_API/File_System_API/FileException">FileException</a>);</pre>
) raises (<a href="/en-US/docs/Web/API/FileException">FileException</a>);</pre>

<h5 id="Parameter_3">Parameter</h5>

Expand All @@ -323,7 +323,7 @@ <h5 id="Returns_5">Returns</h5>

<h5 id="Exceptions_5">Exceptions</h5>

<p>This method can raise a <a href="/en-US/docs/DOM/File_API/File_System_API/FileException">FileException</a> with the following codes:</p>
<p>This method can raise a <a href="/en-US/docs/Web/API/FileException">FileException</a> with the following codes:</p>

<table class="standard-table">
<thead>
Expand All @@ -340,7 +340,7 @@ <h5 id="Exceptions_5">Exceptions</h5>
<tr>
<td><code>INVALID_MODIFICATION_ERR</code></td>
<td>
<p>You tried to remove a directory that is not empty. If you want to remove an empty directory, use <a href="/en-US/docs/DOM/File_API/File_System_API/DirectoryEntrySync#removeRecursively()"><code>removeRecursively()</code></a> instead.</p>
<p>You tried to remove a directory that is not empty. If you want to remove an empty directory, use <a href="/en-US/docs/Web/API/DirectoryEntrySync#removerecursively()"><code>removeRecursively()</code></a> instead.</p>
</td>
</tr>
<tr>
Expand All @@ -352,7 +352,7 @@ <h5 id="Exceptions_5">Exceptions</h5>

<h3 id="getParent">getParent()</h3>

<p>Look up the parent <a href="/en-US/docs/DOM/File_API/File_System_API/DirectoryEntrySync"><code>DirectoryEntrySync</code></a> containing the entry. If this entry is the root of its file system, then the parent is itself.</p>
<p>Look up the parent <a href="/en-US/docs/Web/API/DirectoryEntrySync"><code>DirectoryEntrySync</code></a> containing the entry. If this entry is the root of its file system, then the parent is itself.</p>

<pre>void getParent ();</pre>

Expand All @@ -363,7 +363,7 @@ <h5 id="Parameter_4">Parameter</h5>
<h5 id="Returns_6">Returns</h5>

<dl>
<dt><code><a href="/en-US/docs/DOM/File_API/File_System_API/DirectoryEntrySync">DirectoryEntrySync</a></code></dt>
<dt><code><a href="/en-US/docs/Web/API/DirectoryEntrySync">DirectoryEntrySync</a></code></dt>
<dd>An object that represents a directory in the file system.</dd>
</dl>

Expand All @@ -379,6 +379,6 @@ <h2 id="See_also">See also</h2>

<p>Specification:{{ spec("http://dev.w3.org/2009/dap/file-system/pub/FileSystem/", "File API: Directories and System Specification", "WD") }}</p>

<p>Reference: <a href="/en-US/docs/DOM/File_API/File_System_API">File System API</a></p>
<p>Reference: <a href="/en-US/docs/Web/API/File_and_Directory_Entries_API/Introduction">File System API</a></p>

<p>Introduction: <a href="/en-US/docs/DOM/File_APIs/Filesystem/Basic_Concepts_About_the_Filesystem_API">Basic Concepts About the File System API</a></p>
<p>Introduction: <a href="/en-US/docs/Web/API/File_and_Directory_Entries_API/Introduction">Basic Concepts About the File System API</a></p>
2 changes: 1 addition & 1 deletion files/en-us/web/api/filesystemfileentry/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@
---
<div>{{APIRef("File System API")}}{{SeeCompatTable}}</div>

<p>The <strong><code>FileSystemFileEntry</code></strong> interface of the <a href="/en-US/docs/DOM/File_API/File_System_API">File System API</a> represents a file in a file system. It offers properties describing the file's attributes, as well as the {{domxref("FileSystemFileEntry.file", "file()")}} method, which creates a {{domxref("File")}} object that can be used to read the file.</p>
<p>The <strong><code>FileSystemFileEntry</code></strong> interface of the <a href="/en-US/docs/Web/API/File_and_Directory_Entries_API/Introduction">File System API</a> represents a file in a file system. It offers properties describing the file's attributes, as well as the {{domxref("FileSystemFileEntry.file", "file()")}} method, which creates a {{domxref("File")}} object that can be used to read the file.</p>

<h2 id="Properties">Properties</h2>

Expand Down
6 changes: 3 additions & 3 deletions files/en-us/web/api/filesystemsync/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@
<p>{{APIRef("File System API")}} {{non-standard_header}}</p>
</div>

<p>In the <a href="/en-US/docs/DOM/File_API/File_System_API">File System API</a>, a <code>FileSystemSync </code>object represents a file system. It has two properties.</p>
<p>In the <a href="/en-US/docs/Web/API/File_and_Directory_Entries_API/Introduction">File System API</a>, a <code>FileSystemSync </code>object represents a file system. It has two properties.</p>

<h2 id="About_this_document">About this document</h2>

Expand Down Expand Up @@ -57,6 +57,6 @@ <h2 id="See_also">See also</h2>

<p>Specification:{{ spec("http://dev.w3.org/2009/dap/file-system/pub/FileSystem/", "File API: Directories and System Specification", "WD") }}</p>

<p>Reference: <a href="/en-US/docs/DOM/File_API/File_System_API">File System API</a></p>
<p>Reference: <a href="/en-US/docs/Web/API/File_and_Directory_Entries_API/Introduction">File System API</a></p>

<p>Introduction: <a href="/en-US/docs/DOM/File_APIs/Filesystem/Basic_Concepts_About_the_Filesystem_API">Basic Concepts About the File System API</a></p>
<p>Introduction: <a href="/en-US/docs/Web/API/File_and_Directory_Entries_API/Introduction">Basic Concepts About the File System API</a></p>
Original file line number Diff line number Diff line change
Expand Up @@ -91,6 +91,6 @@ <h2 id="Browser_compatibility">Browser compatibility</h2>
<h2 id="See_also">See also</h2>

<ul>
<li><a href="/docs/Web/API/File_System_Access_API">File System Access API</a></li>
<li><a href="/en-US/docs/Web/API/File_System_Access_API">File System Access API</a></li>
<li><a href="https://web.dev/file-system-access/">The File System Access API: simplifying access to local files</a></li>
</ul>
Original file line number Diff line number Diff line change
Expand Up @@ -2,12 +2,12 @@
title: FileSystemWritableFileStream.seek()
slug: Web/API/FileSystemWritableFileStream/seek
tags:
- File
- File System Access API
- FileSystemWritableFileStream
- Method
- stream
- write
- File
- File System Access API
- FileSystemWritableFileStream
- Method
- stream
- write
---
<div>{{draft}}{{securecontext_header}}{{DefaultAPISidebar("File System Access API")}}
</div>
Expand Down Expand Up @@ -71,7 +71,7 @@ <h2 id="Browser_compatibility">Browser compatibility</h2>
<h2 id="See_also">See also</h2>

<ul>
<li><a href="/docs/Web/API/File_System_Access_API">File System Access API</a></li>
<li><a href="/en-US/docs/Web/API/File_System_Access_API">File System Access API</a></li>
<li><a href="https://web.dev/file-system-access/">The File System Access API:
simplifying access to local files</a></li>
</ul>
Loading