From 95c10bf66bf9c1cb15141f7c3c1ff115ea20b083 Mon Sep 17 00:00:00 2001
From: Ben Kelly <wanderview@chromium.org>
Date: Mon, 16 May 2022 21:22:24 +0000
Subject: [PATCH] Compute storage keys to be stored on environments. (#142)

---
 storage.bs | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)

diff --git a/storage.bs b/storage.bs
index 18f7985..619beb0 100644
--- a/storage.bs
+++ b/storage.bs
@@ -222,6 +222,9 @@ anticipated that some APIs will be applicable to both <a>storage types</a> going
 <p>To <dfn export>obtain a storage key for non-storage purposes</dfn>, given an
 <a for=/>environment</a> <var>environment</var>, run these steps:
 
+<p class=note>This algorithm will be removed or updated once the html spec is
+modified to store a storage key directly on environment.
+
 <ol>
  <li><p>Let <var>origin</var> be <var>environment</var>'s
  <a for="environment settings object">origin</a> if <var>environment</var> is an
@@ -231,6 +234,29 @@ anticipated that some APIs will be applicable to both <a>storage types</a> going
  <li><p>Return a <a>tuple</a> consisting of <var>origin</var>.
 </ol>
 
+<p>To <dfn export>compute a storage key for an environment settings object</dfn>,
+given an <a for=/>origin</a> <var>origin</var> and an optional
+<a for=/>storage key</a> <var>parent-or-outer storage key</var>, run these steps:
+
+<ol>
+  <li>Return a <a>tuple</a> consisting of <var>origin</var>.
+</ol>
+
+<p class=note>The <var>parent-or-outer storage key</var> will be used in the future to
+compute and propagate additional values in the storage key in the future.
+For example, top-level site, the ancestor-chain bit, or anonymous iframe
+nonce.</p>
+
+<p>To <dfn export>compute a storage key for an environment</dfn>, given a
+<a for=/>url</a> <var>creation url</var> and an optional <a for=/>storage key</a>
+<var>parent storage key</var>, run these steps:
+
+<ol>
+  <li>Let <var>origin</var> be <var>creation url</var>'s <a for=url>origin</a>.
+  <li>Return the result of running <a for=/>compute a storage key for an environment
+  settings object</a> given <var>origin</var> and <var>parent storage key</var>
+</ol>
+
 <p>To determine whether a <a>storage key</a> <var>A</var>
 <dfn export for="storage key" lt=equal>equals</dfn> <a>storage key</a> <var>B</var>, run these
 steps: