大网数据广告活动
Web 标准与前端开发

Preserving sessions across reloads

· 52CE 我爱测

One issue with the Prompt API is that the browser doesn't store session information across browser reloads — this is not a surprise, as the web is stateless by default, but it is an issue nonetheless. To restore session context after a reload or browser restart, you will have to

Prompt API

One issue with the Prompt API is that the browser doesn't store session information across browser reloads — this is not a surprise, as the web is stateless by default, but it is an issue nonetheless. To restore session context after a reload or browser restart, you will have to implement a mechanism to save the conversation and restore it using a server- or client-side solution.

This article shows you how to implement a basic query-and-respond example (much like the complete example in our first Prompt API guide) that includes a session-preserving solution created using Web Storage.

[!NOTE] To check out the complete codebase in more detail, view the full source code.

The user interface

The HTML for this example features a textarea element to enter prompts into, and a p to write the API's responses into. It also features three button elements — one to submit the prompt to the API, one to abort an ongoing prompt request, and one to clear the saved session history.

<h1>Prompt API demo</h1>
<p>
  This demo stores your previous session prompt history using the Web Storage
  API, and provides an option to delete it. First released in Chrome 148.
</p>

<h2>Input</h2>

<form>
  <div>
    <label for="prompt-text">Enter prompt text:</label>
    <textarea id="prompt-text" name="promptText" rows="6"></textarea>
  </div>
  <button type="submit" id="submit">Submit query</button
  ><button type="button" id="abort">Abort query</button>
  <button type="button" id="delete-session">Delete saved prompt history</button>
</form>

<h2>Output</h2>

<p class="prompt-output"></p>

For brevity, we won't show the CSS; there is nothing significant to discuss, style-wise.

Retrieving the prompt history

When the page first loads, we need to check whether we have any prompt history saved, and if so, load it into the session.

We start by defining a variable called promptHistory to store the saved history:

let promptHistory;

We then check whether there is a property in Window.localStorage called promptHistory, which is the key we will store our prompt history under. If there is, we retrieve that storage item using Storage.getItem, parse it into an array using JSON.parse(), and store it in the variable. We also enable the delete <button> now that there is history to delete. If there is no stored key called promptHistory, we set the promptHistory variable to an empty array.

if (localStorage.promptHistory) {
  promptHistory = JSON.parse(localStorage.getItem("promptHistory"));
  deleteBtn.disabled = false;
} else {
  promptHistory = [];
}

Adding the prompt history to the session

Next, we create a session variable to hold our session. Because using the API requires transient activation, we populate session inside a focus event handler on the <textarea>. When the user focuses the <textarea>, we first check whether the API is supported; if not, we print a non-support message and return early. Next, we check whether session already has a value assigned (we don't want to create a new session each time). If not, we run the init() function, which generates a LanguageModel instance using the custom getSession() function. We pass getSession() the promptHistory variable from earlier to add the saved history to the session on creation.

Provided generation is successful, we assign the resulting LanguageModel instance to the session variable, print a success message to the output <p>, and enable the submit <button> (now the session is available, we can start prompting it).

let session;
textarea.addEventListener("focus", () => {
  if (!("LanguageModel" in window)) {
    promptOutput.innerHTML = `<span class="error">Your browser doesn't support the Prompt API!</span>`;
    return;
  }

  if (!session) {
    init();
  }
});

async function init() {
  session = await getSession(promptHistory);
  promptOutput.textContent = `Session created.`;
  submitBtn.disabled = false;
}

Now we'll look at the getSession() function. The function starts by running our desired model requirements through the availability() method to see if it is available:

  • If it returns unavailable, we print an appropriate error message to the output <p>.
  • If it returns available, we create a session using the create() method, passing it several options including initialPrompts, which we set to our history parameter. This is what gives the session the previous prompt history as context after each page load.
  • If it returns a different value (that is, downloadable or downloading), we run the same create() method call, but this time we include a monitor that prints out the percentage of the additional data downloaded to the output <p> each time the CreateMonitor.downloadprogress_event event fires.
async function getSession(history) {
  const availability = await LanguageModel.availability({
    expectedInputs: [{ type: "text", languages: ["en"] }],
    expectedOutputs: [{ type: "text", languages: ["en"] }],
  });
  if (availability === "unavailable") {
    console.log(`Language model not available.`);
    return undefined;
  } else if (availability === "available") {
    return await LanguageModel.create({
      initialPrompts: history,
      expectedInputs: [{ type: "text", languages: ["en"] }],
      expectedOutputs: [{ type: "text", languages: ["en"] }],
    });
  }
  return await LanguageModel.create({
    initialPrompts: history,
    expectedInputs: [{ type: "text", languages: ["en"] }],
    expectedOutputs: [{ type: "text", languages: ["en"] }],
    monitor(monitor) {
      monitor.addEventListener("downloadprogress", (e) => {
        promptOutput.textContent = `Downloading model data ${Math.floor(e.loaded * 100)}%`;
      });
    },
  });
}

Updating the history after each prompt

When the form is submitted, the contents of the <textarea> are included in a LanguageModel.prompt call and the returned result is included in the output <p> so the user can see it.

The most significant part of this example is how we store the history for later — note how after each successful operation, we Array.push two objects to the promptHistory array, one representing the user prompt and one representing the assistant response, in the correct format for the API to interpret. We then JSON.stringify the updated promptHistory and store it in the promptHistory web storage item using Storage.setItem. At this point, we also enable the delete <button>, as there is definitely history to delete at this point.

form.addEventListener("submit", handleSubmission);

async function handleSubmission(e) {
  e.preventDefault();

  if (textarea.value === "") {
    promptOutput.innerHTML = `<span class="error">No text entered!</span>`;
    return;
  }

  try {
    promptOutput.textContent = "...generating response...";
    submitBtn.disabled = true;
    abortBtn.disabled = false;

    const controller = new AbortController();
    abortBtn.addEventListener("click", () => {
      controller.abort("Query aborted by user.");
      submitBtn.disabled = false;
      abortBtn.disabled = true;
    });

    const response = await session.prompt(textarea.value, {
      signal: controller.signal,
    });

    promptOutput.textContent = response;

    submitBtn.disabled = false;
    abortBtn.disabled = true;
    console.log(`${session.contextUsage}/${session.contextWindow}`);

    promptHistory.push({ role: "user", content: textarea.value });
    promptHistory.push({ role: "assistant", content: response });
    localStorage.setItem("promptHistory", JSON.stringify(promptHistory));
    deleteBtn.disabled = false;
  } catch (e) {
    promptOutput.innerHTML = `<span class="error">${e}</span>`;
  }
}

Wiring up the delete button

When the delete <button> is clicked, we remove the promptHistory item from local storage using Storage.removeItem. We also reload the page using Location.reload() as a cheap way to avoid continuity issues between the local storage and the model session.

deleteBtn.addEventListener("click", () => {
  localStorage.removeItem("promptHistory");
  window.location.reload();
});

Result

Run the demo in a new tab to observe its functionality (see also the full source code). We weren't able to provide a working version of this demo embedded in the page because MDN clears out all the storage data.

Try submitting a prompt such as "My favorite color is red", then reload the page and try submitting "What is my favorite color?", for example. The model should remember your previous conversation.

Now try the same thing, but press "Delete saved prompt history" in between. This time the model will not remember your previous conversation.

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。