From 862e3897965739afa728344b48529df9143f0300 Mon Sep 17 00:00:00 2001
From: Greg Stoll <gstoll@mozilla.com>
Date: Sat, 28 Mar 2026 21:26:04 -0500
Subject: [PATCH] Add note on remembering previously allowed ports (#107)

Add a note that user agents may remember previously allowed ports with
a warnings that devices won't always have the same port.

Fixed #107.
---
 index.html | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/index.html b/index.html
index e8801f5..f2167ec 100644
--- a/index.html
+++ b/index.html
@@ -400,6 +400,17 @@ <h3>
               ports which the user has allowed the site to access
               as the result of a previous call to {{Serial/requestPort()}}.
               </li>
+              <div class="note">
+                An implementation is allowed to have a storage mechanism that
+                remembers ports that have been allowed from previous calls of
+                {{Serial/requestPort()}} from previous times the user has
+                visited the same site. Implementations should take caution that
+                a device will not always have the same port name, as this is up
+                to the operating system, and thus there is a danger that
+                allowing access to a previously allowed port may grant access
+                to a different device than the user intended. As such,
+                implementations should communicate this risk to the user.
+              </div>
               <li>Let |ports| be the sequence of the {{SerialPort}}s
               representing the ports in |availablePorts|.
               </li>