Skip to content

Commit

Permalink
chore(rebuild): Update a reference to FileSystemHandle/entry
Browse files Browse the repository at this point in the history 
See #408. This does not completely fix that issue, since there is still once more reference that will be fixed with whatwg/fs#101

SHA: f0fd3b3
Reason: push, by @a-sully

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
  • Loading branch information
@a-sully @github-actions
a-sully and github-actions[bot] committed Apr 18, 2023
1 parent c2cf542 commit ecc2d32
Showing 1 changed file with 31 additions and 21 deletions.
52 changes: 31 additions & 21 deletions index.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
<link href="https://www.w3.org/StyleSheets/TR/2021/cg-draft" rel="stylesheet">
<meta content="Bikeshed version d9bd89757, updated Thu Mar 23 10:06:53 2023 -0700" name="generator">
<link href="https://wicg.github.io/file-system-access/" rel="canonical">
<meta content="b22b8fb4eb3d31c6851a4c6382cc96eb2174535f" name="document-revision">
<meta content="f0fd3b355cdb4f874c6236f26ea524ebf0b5fe93" name="document-revision">
<style>
.domintro dt {
font-family: Menlo, Consolas, "DejaVu Sans Mono", Monaco, monospace;
Expand Down Expand Up @@ -1011,6 +1011,9 @@ <h3 class="heading settled" data-level="2.2" id="permissions"><span class="secno
</ol>
</ol>
</div>
</dl>
<p class="issue" id="issue-45c3f8b0"><a class="self-link" href="#issue-45c3f8b0"></a> Make these checks no longer associated with an entry. <a href="https://github.com/whatwg/fs/issues/101">[Issue #whatwg/fs#101]</a></p>
<dl>
<dt data-md><a data-link-type="dfn" href="https://wicg.github.io/permissions-request/#permission-request-algorithm" id="ref-for-permission-request-algorithm">permission request algorithm</a>
<dd data-md>
<div class="algorithm" data-algorithm="permission request algorithm">
Expand Down Expand Up @@ -1495,22 +1498,14 @@ <h4 class="heading settled" data-level="3.2.2" id="api-filepickeroptions-startin
<li data-md>
<p>Let <var>origin</var> be <var>environment</var>’s <a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/webappapis.html#concept-settings-object-origin" id="ref-for-concept-settings-object-origin③">origin</a>.</p>
<li data-md>
<p>If <var>startIn</var> is a <code class="idl"><a data-link-type="idl" href="https://fs.spec.whatwg.org/#filesystemhandle" id="ref-for-filesystemhandle⑥">FileSystemHandle</a></code>:</p>
<p>If <var>startIn</var> is a <code class="idl"><a data-link-type="idl" href="https://fs.spec.whatwg.org/#filesystemhandle" id="ref-for-filesystemhandle⑥">FileSystemHandle</a></code> and is not <a data-link-type="dfn">in the origin private file system</a>:</p>
<ol>
<li data-md>
<p>Let <var>entry</var> be <var>startIn</var>’s <a data-link-type="dfn">entry</a>.</p>
<p>Let <var>entry</var> be the result of <a data-link-type="dfn" href="https://fs.spec.whatwg.org/#locating-an-entry" id="ref-for-locating-an-entry">locating an entry</a> given <var>startIn</var>’s <a data-link-type="dfn" href="https://fs.spec.whatwg.org/#filesystemhandle-locator" id="ref-for-filesystemhandle-locator">locator</a>.</p>
<li data-md>
<p>If <var>entry</var> does not represent a <a data-link-type="dfn" href="https://fs.spec.whatwg.org/#entry" id="ref-for-entry①">file system entry</a> in an <a data-link-type="dfn" href="https://fs.spec.whatwg.org/#origin-private-file-system" id="ref-for-origin-private-file-system②">origin private file system</a>:</p>
<ol>
<li data-md>
<p>If <var>entry</var> is a <a data-link-type="dfn" href="https://fs.spec.whatwg.org/#file" id="ref-for-file">file entry</a>, and a path on the local file system
corresponding to the parent directory of <var>entry</var> can be determined,
then return that path.</p>
<li data-md>
<p>If <var>entry</var> is a <a data-link-type="dfn" href="https://fs.spec.whatwg.org/#directory" id="ref-for-directory">directory entry</a>, and a path on the local file system
corresponding to <var>entry</var> can be determined,
then return that path.</p>
</ol>
<p>If <var>entry</var> is a <a data-link-type="dfn" href="https://fs.spec.whatwg.org/#file" id="ref-for-file">file entry</a>, return the path of <var>entry</var>’s <a data-link-type="dfn" href="https://fs.spec.whatwg.org/#entry-parent" id="ref-for-entry-parent②">parent</a> in the local file system.</p>
<li data-md>
<p>If <var>entry</var> is a <a data-link-type="dfn" href="https://fs.spec.whatwg.org/#directory" id="ref-for-directory">directory entry</a>, return <var>entry</var>’s path in the local file system.</p>
</ol>
<li data-md>
<p>If <var>id</var> is non-empty:</p>
Expand Down Expand Up @@ -1548,7 +1543,7 @@ <h4 class="heading settled" data-level="3.2.2" id="api-filepickeroptions-startin
</div>
<div class="algorithm" data-algorithm="remember a picked directory">
To <dfn class="dfn-paneled" data-dfn-for="WellKnownDirectory" data-dfn-type="dfn" data-noexport id="wellknowndirectory-remember-a-picked-directory">remember a picked directory</dfn>, given an optional <a data-link-type="dfn" href="https://infra.spec.whatwg.org/#string" id="ref-for-string③">string</a> <var>id</var>,
a <a data-link-type="dfn" href="https://fs.spec.whatwg.org/#entry" id="ref-for-entry②">file system entry</a> <var>entry</var>, and an <a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/webappapis.html#environment-settings-object" id="ref-for-environment-settings-object①">environment settings object</a> <var>environment</var>,
a <a data-link-type="dfn" href="https://fs.spec.whatwg.org/#entry" id="ref-for-entry①">file system entry</a> <var>entry</var>, and an <a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/webappapis.html#environment-settings-object" id="ref-for-environment-settings-object①">environment settings object</a> <var>environment</var>,
run the following steps:
<ol>
<li data-md>
Expand Down Expand Up @@ -1834,7 +1829,7 @@ <h3 class="heading settled" data-level="3.6" id="drag-and-drop"><span class="sec
<p>Run the following steps <a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/infrastructure.html#in-parallel" id="ref-for-in-parallel⑧">in parallel</a>:</p>
<ol>
<li data-md>
<p>Let <var>entry</var> be the <a data-link-type="dfn" href="https://fs.spec.whatwg.org/#entry" id="ref-for-entry③">file system entry</a> representing the dragged file or directory.</p>
<p>Let <var>entry</var> be the <a data-link-type="dfn" href="https://fs.spec.whatwg.org/#entry" id="ref-for-entry②">file system entry</a> representing the dragged file or directory.</p>
<li data-md>
<p>If <var>entry</var> is a <a data-link-type="dfn" href="https://fs.spec.whatwg.org/#file" id="ref-for-file④">file entry</a>:</p>
<ol>
Expand Down Expand Up @@ -1971,7 +1966,7 @@ <h3 class="heading settled" data-level="6.2" id="security-ransomware"><span clas
Additionally user agents can grant write access to files at whatever granularity they deem
appropriate.</p>
<h3 class="heading settled" data-level="6.3" id="filling-up-disk"><span class="secno">6.3. </span><span class="content">Filling up a users disk</span><a class="self-link" href="#filling-up-disk"></a></h3>
<p>Other than files in the <a data-link-type="dfn" href="https://fs.spec.whatwg.org/#origin-private-file-system" id="ref-for-origin-private-file-system③">origin private file system</a>, files written by this API are not subject
<p>Other than files in the <a data-link-type="dfn" href="https://fs.spec.whatwg.org/#origin-private-file-system" id="ref-for-origin-private-file-system②">origin private file system</a>, files written by this API are not subject
to <a data-link-type="dfn" href="https://storage.spec.whatwg.org/#storage-quota" id="ref-for-storage-quota">storage quota</a>. As such websites can fill up a users disk without being limited by
quota, which could leave a users device in a bad state (do note that even with storage that is
subject to <a data-link-type="dfn" href="https://storage.spec.whatwg.org/#storage-quota" id="ref-for-storage-quota①">storage quota</a> it is still possible to fill up, or come close to filling up, a users
Expand Down Expand Up @@ -2148,23 +2143,35 @@ <h3 class="no-num no-ref heading settled" id="index-defined-here"><span class="c
<span id="infopaneltitle-for-a3041a88fb118cb60f71471202b27eb9" style="display:none">Info about the 'file system entry' external reference.</span><a href="https://fs.spec.whatwg.org/#entry">https://fs.spec.whatwg.org/#entry</a><b>Referenced in:</b>
<ul>
<li><a href="#ref-for-entry">2.2. Permissions</a>
<li><a href="#ref-for-entry①">3.2.2. Starting Directory</a> <a href="#ref-for-entry②">(2)</a>
<li><a href="#ref-for-entry③">3.6. Drag and Drop</a>
<li><a href="#ref-for-entry①">3.2.2. Starting Directory</a>
<li><a href="#ref-for-entry②">3.6. Drag and Drop</a>
</ul>
</aside>
<aside aria-labelledby="infopaneltitle-for-608afb57686bca41a876438f2ca4ea01" class="dfn-panel" data-for="608afb57686bca41a876438f2ca4ea01" id="infopanel-for-608afb57686bca41a876438f2ca4ea01">
<span id="infopaneltitle-for-608afb57686bca41a876438f2ca4ea01" style="display:none">Info about the 'locating an entry' external reference.</span><a href="https://fs.spec.whatwg.org/#locating-an-entry">https://fs.spec.whatwg.org/#locating-an-entry</a><b>Referenced in:</b>
<ul>
<li><a href="#ref-for-locating-an-entry">3.2.2. Starting Directory</a>
</ul>
</aside>
<aside aria-labelledby="infopaneltitle-for-0c42b246e80597b912ea885389750d22" class="dfn-panel" data-for="0c42b246e80597b912ea885389750d22" id="infopanel-for-0c42b246e80597b912ea885389750d22">
<span id="infopaneltitle-for-0c42b246e80597b912ea885389750d22" style="display:none">Info about the 'locator' external reference.</span><a href="https://fs.spec.whatwg.org/#filesystemhandle-locator">https://fs.spec.whatwg.org/#filesystemhandle-locator</a><b>Referenced in:</b>
<ul>
<li><a href="#ref-for-filesystemhandle-locator">3.2.2. Starting Directory</a>
</ul>
</aside>
<aside aria-labelledby="infopaneltitle-for-488b20e27377df2b11b91bf74aa477a8" class="dfn-panel" data-for="488b20e27377df2b11b91bf74aa477a8" id="infopanel-for-488b20e27377df2b11b91bf74aa477a8">
<span id="infopaneltitle-for-488b20e27377df2b11b91bf74aa477a8" style="display:none">Info about the 'origin private file system' external reference.</span><a href="https://fs.spec.whatwg.org/#origin-private-file-system">https://fs.spec.whatwg.org/#origin-private-file-system</a><b>Referenced in:</b>
<ul>
<li><a href="#ref-for-origin-private-file-system">1. Introduction</a>
<li><a href="#ref-for-origin-private-file-system①">2.2. Permissions</a>
<li><a href="#ref-for-origin-private-file-system②">3.2.2. Starting Directory</a>
<li><a href="#ref-for-origin-private-file-system③">6.3. Filling up a users disk</a>
<li><a href="#ref-for-origin-private-file-system②">6.3. Filling up a users disk</a>
</ul>
</aside>
<aside aria-labelledby="infopaneltitle-for-473d71ed7162ce5db3c35957be1a084d" class="dfn-panel" data-for="473d71ed7162ce5db3c35957be1a084d" id="infopanel-for-473d71ed7162ce5db3c35957be1a084d">
<span id="infopaneltitle-for-473d71ed7162ce5db3c35957be1a084d" style="display:none">Info about the 'parent' external reference.</span><a href="https://fs.spec.whatwg.org/#entry-parent">https://fs.spec.whatwg.org/#entry-parent</a><b>Referenced in:</b>
<ul>
<li><a href="#ref-for-entry-parent">2.2. Permissions</a> <a href="#ref-for-entry-parent①">(2)</a>
<li><a href="#ref-for-entry-parent②">3.2.2. Starting Directory</a>
</ul>
</aside>
<aside aria-labelledby="infopaneltitle-for-837280b5a0a66b6ac9426b081795eb50" class="dfn-panel" data-for="837280b5a0a66b6ac9426b081795eb50" id="infopanel-for-837280b5a0a66b6ac9426b081795eb50">
Expand Down Expand Up @@ -2709,6 +2716,8 @@ <h3 class="no-num no-ref heading settled" id="index-defined-elsewhere"><span cla
<li><span class="dfn-paneled" id="8512fb29d0eb31edcc9f625c19168119">directory entry</span>
<li><span class="dfn-paneled" id="6449045a7c035dd50b88afdac2cd2f46">file entry</span>
<li><span class="dfn-paneled" id="a3041a88fb118cb60f71471202b27eb9">file system entry</span>
<li><span class="dfn-paneled" id="608afb57686bca41a876438f2ca4ea01">locating an entry</span>
<li><span class="dfn-paneled" id="0c42b246e80597b912ea885389750d22">locator</span>
<li><span class="dfn-paneled" id="488b20e27377df2b11b91bf74aa477a8">origin private file system</span>
<li><span class="dfn-paneled" id="473d71ed7162ce5db3c35957be1a084d">parent</span>
<li><span class="dfn-paneled" id="837280b5a0a66b6ac9426b081795eb50">truncate(size)</span>
Expand Down Expand Up @@ -2920,6 +2929,7 @@ <h2 class="no-num no-ref heading settled" id="idl-index"><span class="content">I
</pre>
<h2 class="no-num no-ref heading settled" id="issues-index"><span class="content">Issues Index</span><a class="self-link" href="#issues-index"></a></h2>
<div style="counter-reset:issue">
<div class="issue"> Make these checks no longer associated with an entry. <a href="https://github.com/whatwg/fs/issues/101">[Issue #whatwg/fs#101]</a> <a class="issue-return" href="#issue-45c3f8b0" title="Jump to section">↵</a></div>
<div class="issue"> Ideally this user activation requirement would be defined upstream. <a href="https://github.com/WICG/permissions-request/issues/2">[Issue #WICG/permissions-request#2]</a> <a class="issue-return" href="#issue-88417955" title="Jump to section">↵</a></div>
<div class="issue"> Currently <code class="idl"><a data-link-type="idl" href="#enumdef-filesystempermissionmode">FileSystemPermissionMode</a></code> can only be <code class="idl"><a data-link-type="idl" href="#dom-filesystempermissionmode-read">"read"</a></code> or <code class="idl"><a data-link-type="idl" href="#dom-filesystempermissionmode-readwrite">"readwrite"</a></code>. In
the future we might want to add a "write" mode as well to support write-only handles. <a href="https://github.com/wicg/file-system-access/issues/119">[Issue #119]</a> <a class="issue-return" href="#issue-7fc2f5c7" title="Jump to section">↵</a></div>
Expand Down

0 comments on commit ecc2d32

Please sign in to comment.