Skip to content
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.

Commit 5d31999

Browse files
noamrnoamr
committedDec 9, 2024
Use new quota algorithm
See WICG/pending-beacon#87 (comment)
1 parent 1308484 commit 5d31999

File tree

1 file changed

+128
-47
lines changed

1 file changed

+128
-47
lines changed
 

‎fetch.bs

+128-47
Original file line numberDiff line numberDiff line change
@@ -2737,6 +2737,13 @@ a <a for=/>list</a> of <a for="/" data-lt="fetch record">fetch records</a>.
27372737
<dfn export for="fetch group" id=concept-defer=fetch-record>deferred fetch records</dfn>,
27382738
a <a for=/>list</a> of <a data-lt="deferred fetch record">deferred fetch records</a>.
27392739

2740+
<p>A <a for=fetch>fetch group</a> has an associated boolean
2741+
<dfn for="fetch group">is eligible for deferred fetching</dfn>.
2742+
2743+
To initialize a <a for=fetch>fetch group</a> for a given <a>environment settings object</a>
2744+
<var>settings</var>, set its <a for="fetch group">is eligible for deferred fetching</a> to the
2745+
result of calling <a>check deferred fetching eligibility</a> given <var>settings</var>.
2746+
27402747
<p>A <dfn export>fetch record</dfn> is a [=struct=]. It has the following items:
27412748

27422749
<dl>
@@ -6767,9 +6774,9 @@ i.e., when a <a>fetch group</a> is <a for="fetch group">terminated</a>, or after
67676774
<li><p>If <var>request</var>'s <a for=request>URL</a> is not a
67686775
<a>potentially trustworthy url</a>, then throw a "{{SecurityError}}" {{DOMException}}.
67696776

6770-
<li><p>If the result of calling [$Is feature enabled in document for origin?$] given
6771-
"<code>deferred-fetch</code>", <var>document</var>, and <var>request</var>'s
6772-
<a for=request>origin</a> is <code>Disabled</code>, then throw a {{NotAllowedError}}.
6777+
<li><p>If <var>request</var>'s <a for=request>client</a>'s <a for=fetch>fetch group</a>
6778+
<a for="fetch group">is eligible for deferred fetching</a> is false, then throw a
6779+
"{{NotAllowedError}}" {{DOMException}}.
67736780

67746781
<li>
67756782
<p>If <var>request</var>'s <a for=request>body</a> is non-null then:
@@ -6784,50 +6791,11 @@ i.e., when a <a>fetch group</a> is <a for="fetch group">terminated</a>, or after
67846791

67856792
<p class=note>This disallows sending deferred fetches with a live {{ReadableStream}}.
67866793

6787-
<li><p>Let <var>totalScheduledDeferredBytesForTopLevelDocument</var> be
6788-
<var>request</var>'s <a for=request>body</a>'s <a for=body>length</a>.
6789-
6790-
<li><p>Let <var>totalScheduledDeferredBytesForOrigin</var> be <var>request</var>'s
6791-
<a for=request>body</a>'s <a for=body>length</a>.
6792-
6793-
<li>
6794-
<p><a for=list>For each</a> <var>navigable</var> of <var>document</var>'s
6795-
<a>node navigable</a>'s <a for=navigable>top-level traversable</a>'s
6796-
<a for=Document>inclusive descendant navigables</a>:
6797-
6798-
<p class=note>This algorithm asserts that this deferred fetch doesn't exceed two quotas: one for
6799-
the top-level document (640 kibibytes), and one for the reporting origin (64 kibibytes). The
6800-
larger quota ensures that the top-level {{Document}} and its subresources don't continue using
6801-
an unlimited amount of bandwidth after being destroyed. The smaller quota ensures that a single
6802-
reporting sink doesn't reserve the whole quota to itself.
6803-
6804-
<ol>
6805-
<li>
6806-
<p><a for=list>For each</a> <a>deferred fetch record</a> <var>deferredRecord</var> in
6807-
<var>navigable</var>'s <a>active document</a>'s <a for=fetch>fetch group</a>'s
6808-
<a for="fetch group">deferred fetch records</a>:</p>
6809-
6810-
<ol>
6811-
<li><p>Let <var>length</var> be <var>deferredRecord</var>'s
6812-
<a for="deferred fetch record">request</a>'s <a for=request>body</a>'s
6813-
<a for=body>length</a>.
6814-
6815-
<li><p>Increment <var>totalScheduledDeferredBytesForTopLevelDocument</var> by <var>length</var>.
6816-
6817-
<li><p>If <var>totalScheduledDeferredBytesForTopLevelDocument</var> is greater than 640
6818-
kibibytes, then throw a "{{QuotaExceededError}}" {{DOMException}}.
6819-
6820-
<li><p>If <var>deferredRecord</var>'s <a for="deferred fetch record">request</a>'s
6821-
<a for=request>URL</a>'s <a for=url>origin</a> is <a>same origin</a> with
6822-
<var>request</var>'s <a for=request>origin</a>, then increment
6823-
<var>totalScheduledDeferredBytesForOrigin</var> by <var>length</var>.
6824-
6825-
<li><p>If <var>totalScheduledDeferredBytesForOrigin</var> is greater than 64 kibibytes, then
6826-
throw a "{{QuotaExceededError}}" {{DOMException}}.
6827-
</ol>
6828-
</li>
6829-
</ol>
6830-
</li>
6794+
<li><p>If the
6795+
<a>available deferred fetching quota</a> given <var>document</var> and <var>request</var>'s
6796+
<a for=request>URL</a>'s <a for=url>origin</a> is less than <var>request</var>'s
6797+
<a for=request>body</a>'s <a for=body>length</a>, then throw a "{{QuotaExceededError}}"
6798+
{{DOMException}}.
68316799
</ol>
68326800

68336801
<li><p>Set <var>request</var>'s <a for=request>service-workers mode</a> to "<code>none</code>".
@@ -6863,6 +6831,119 @@ i.e., when a <a>fetch group</a> is <a for="fetch group">terminated</a>, or after
68636831
</ol>
68646832
</div>
68656833

6834+
<div algorithm>
6835+
<p>To get the <dfn>available deferred fetching quota</dfn> given a <code>Document</code>
6836+
<var>document</var> and an <a for=/>origin</a>-or-null <var>origin</var>:
6837+
6838+
<p class=note>This algorithm asserts that this deferred fetch doesn't exceed two quotas: one for the
6839+
top-level document (640 kibibytes), and one for the reporting origin (64 kibibytes). The larger
6840+
quota ensures that the top-level {{Document}} and its subresources don't continue using an unlimited
6841+
amount of bandwidth after being destroyed. The smaller quota ensures that a single reporting sink
6842+
doesn't reserve the whole quota to itself.
6843+
6844+
<ol>
6845+
<li><p>Let <var>closestSameOriginInclusiveAncestor</var> be <var>document</var>'s
6846+
<a>node navigable</a>.
6847+
6848+
<li><p>While <var>closestSameOriginInclusiveAncestor</var>'s <a for=navigable>parent</a> is a
6849+
<a for=/>navigable</a> whose <a>active document</a>'s <a for=Document>origin</a> is <a>same origin</a>
6850+
with <var>document</var>'s <a for=Document>origin</a>, set
6851+
<var>closestSameOriginInclusiveAncestor</var> to <var>closestSameOriginInclusiveAncestor</var>'s
6852+
<a for=navigable>parent</a>.
6853+
6854+
<li><p>Let <var>directRelativeSameOriginNavigables</var> be the
6855+
<a>inclusive direct same origin descendants</a> of <var>closestSameOriginInclusiveAncestor</var>.
6856+
6857+
<li><p>Let <var>remainingTotalQuota</var> be 640 kibibytes if
6858+
<var>directRelativeSameOriginNavigables</var> includes <var>document</var>'s
6859+
<a>node navigable</a>'s <a for=navigable>top-level traversable</a>, and 64 kibibytes otherwise.
6860+
6861+
<li><p>Let <var>remainingQuotaForOrigin</var> be 64 kibibytes.
6862+
6863+
<li>
6864+
<p><a for=list>For each</a> <var>navigable</var> in
6865+
<var>directRelativeSameOriginNavigables</var>:
6866+
6867+
<ol>
6868+
<li>
6869+
<p><a for=list>For each</a> <a>deferred fetch record</a> <var>deferredRecord</var> in
6870+
<var>navigable</var>'s <a>active document</a>'s <a for=fetch>fetch group</a>'s
6871+
<a for="fetch group">deferred fetch records</a>:</p>
6872+
6873+
<ol>
6874+
<li><p>Let <var>length</var> be <var>deferredRecord</var>'s
6875+
<a for="deferred fetch record">request</a>'s <a for=request>body</a>'s
6876+
<a for=body>length</a>.
6877+
6878+
<li><p>Decrement <var>remainingTotalQuota</var> by <var>length</var>.
6879+
6880+
<li><p>If <var>origin</var> is not null, and <var>deferredRecord</var>'s
6881+
<a for="deferred fetch record">request</a>'s <a for=request>URL</a>'s <a for=url>origin</a> is
6882+
<a>same origin</a> with <var>origin</var>, then decrement <var>remainingQuotaForOrigin</var> by
6883+
<var>length</var>.
6884+
</ol>
6885+
</li>
6886+
6887+
<li><p>Let <var>navigableContainers</var> be a list of all <a>shadow-including descendants</a> of
6888+
<var>navigable</var>'s <a>active document</a> that are <a>navigable containers</a>.
6889+
6890+
<li>
6891+
<p><a for=list>For each</a> <var>childNavigable</var> of <var>navigableContainers</var>:
6892+
6893+
<ol>
6894+
<li><p>If <var>childNavigable</var>'s <a>active document</a>'s <a for=Document>origin</a> is
6895+
not <a>same origin</a> with <a for=/>navigable</a>'s <a>active document</a>'s
6896+
<a for=Document>origin</a> and <var>childNavigable</var>'s <a>active document</a>'s
6897+
<a for=fetch>fetch group</a>'s <a for="fetch group">is eligible for deferred fetching</a> is true,
6898+
then decrement <var>remainingTotalQuota</var> by 64 kibibytes.
6899+
</ol>
6900+
</li>
6901+
</ol>
6902+
</li>
6903+
6904+
<li><p>If <var>remainingTotalQuota</var> is less than <var>remainingQuotaForOrigin</var>, then
6905+
return <var>remainingTotalQuota</var>.
6906+
6907+
<li><p>Return <var>remainingQuotaForOrigin</var>.
6908+
</ol>
6909+
</div>
6910+
6911+
<div algorithm>
6912+
<p>To get the <dfn>inclusive direct same origin descendants</dfn> of a <a for=/>navigable</a>
6913+
<var>root</var>:</p>
6914+
6915+
<ol>
6916+
<li><p>Let <var>descendants</var> be « <var>root</var> ».
6917+
6918+
<li><p>Let <var>navigableContainers</var> be a list of all <a>shadow-including descendants</a>
6919+
of <var>root</var>'s <a>active document</a> that are <a>navigable containers</a>.
6920+
6921+
<li><p><a for=list>For each</a> <var>childNavigable</var> of <var>navigableContainers</var>
6922+
whose <a>active document</a>'s <a for=Document>origin</a> is <a>same origin</a> with
6923+
<a for=/>navigable</a>'s <a>active document</a>'s <a for=Document>origin</a>, <a for=list>extend</a>
6924+
<var>descendants</var> with <var>childNavigable</var>'s
6925+
<a>inclusive direct same origin descendants</a>.
6926+
6927+
<li><p>Return <var>descendants</var>.
6928+
</ol>
6929+
</div>
6930+
6931+
<div algorithm>
6932+
To <dfn>check deferred fetching eligibility</dfn> given an <a>environment settings object</a>
6933+
<var>settings</var>:
6934+
6935+
<ol>
6936+
<li><p>If <var>settings</var> is not a <code>Document</code>, return false.
6937+
6938+
<li><p>If the result of calling [$Is feature enabled in document for origin?$] given
6939+
<var>settings</var> is <code>Disabled</code>, return false.
6940+
6941+
<li><p>If the <a>available deferred fetching quota</a> given <var>settings</var> and null is less
6942+
than 64 kibibytes, return false.
6943+
6944+
<li><p>Return true.
6945+
</div>
6946+
68666947
<div algorithm>
68676948
<p>To <dfn export>process deferred fetches</dfn> given a <a>fetch group</a> <var>fetchGroup</var>:
68686949

0 commit comments

Comments
 (0)
Please sign in to comment.