Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

儲存表單中的憑證

Eiji Kitamura

Meggin Kearney

儲存登入表單中的憑證

盡可能簡化註冊和登入表單。

儲存登入表單中的憑證，讓使用者回訪時不必再次登入。

如要儲存表單中的使用者憑證，請按照下列步驟操作：

在表單中加入 autocomplete。
防止表單提交。
傳送要求進行驗證。
儲存憑證。
更新 UI 或前往個人化頁面。

在表單中加入 `autocomplete`

繼續操作前，請檢查表單是否包含 autocomplete 屬性。這有助於 Credential Management API 從表單中找出 id 和 password，並建構憑證物件。

這也有助於不支援 Credential Management API 的瀏覽器瞭解其語意。如要進一步瞭解自動填入功能，請參閱 Jason Grigsby 的這篇文章。

<form id="signup" method="post">
  <input name="email" type="text" autocomplete="username email" />
  <input name="display-name" type="text" autocomplete="name" />
  <input name="password" type="password" autocomplete="new-password" />
  <input type="submit" value="Sign Up!" />
</form>

防止提交表單

使用者按下提交按鈕時，請防止表單提交，否則會導致頁面轉換：

    var f = document.querySelector('#signup');
    f.addEventListener('submit', e => {
      e.preventDefault();

防止頁面轉換，即可在驗證憑證真實性的同時，保留憑證資訊。

傳送要求進行驗證

如要驗證使用者，請使用 AJAX 將憑證資訊傳送至伺服器。

在伺服器端建立端點 (或直接修改現有端點)，並傳回 HTTP 代碼 200 或 401，讓瀏覽器清楚知道註冊/登入/變更密碼是否成功。

例如：

// Try sign-in with AJAX
fetch('/signin', {
  method: 'POST',
  body: new FormData(e.target),
  credentials: 'include',
});

儲存憑證

如要儲存憑證，請先檢查 API 是否可用，然後以同步或非同步方式，使用表單元素做為引數，例項化 PasswordCredential。呼叫 navigator.credentials.store()。如果無法使用 API，只要將設定檔資訊轉送至下一個步驟即可。

同步範例：

if (window.PasswordCredential) {
  var c = new PasswordCredential(e.target);
  return navigator.credentials.store(c);
} else {
  return Promise.resolve(profile);
}

非同步範例：

if (window.PasswordCredential) {
  var c = await navigator.credentials.create({password: e.target});
  return navigator.credentials.store(c);
} else {
  return Promise.resolve(profile);
}

要求成功後，請儲存憑證資訊。(如果要求失敗，請勿儲存憑證資訊，以免回訪者感到困惑)。

Chrome 瀏覽器取得憑證資訊後，會彈出通知，詢問是否要儲存憑證 (或聯合提供者)。

更新 UI

如果一切順利，請使用個人資料資訊更新 UI，或前往個人化頁面。

     }).then(profile => {
       if (profile) {
         updateUI(profile);
       }
     }).catch(error => {
       showError('Sign-in Failed');
     });
    });

完整程式碼範例

// Get form's DOM object
var f = document.querySelector('#signup');
f.addEventListener('submit', (e) => {
  // Stop submitting form by itself
  e.preventDefault();

  // Try sign-in with AJAX
  fetch('/signin', {
    method: 'POST',
    body: new FormData(e.target),
    credentials: 'include',
  })
    .then((res) => {
      if (res.status == 200) {
        return Promise.resolve();
      } else {
        return Promise.reject('Sign-in failed');
      }
    })
    .then((profile) => {
      // Instantiate PasswordCredential with the form
      if (window.PasswordCredential) {
        var c = new PasswordCredential(e.target);
        return navigator.credentials.store(c);
      } else {
        return Promise.resolve(profile);
      }
    })
    .then((profile) => {
      // Successful sign-in
      if (profile) {
        updateUI(profile);
      }
    })
    .catch((error) => {
      // Sign-in failed
      showError('Sign-in Failed');
    });
});

瀏覽器相容性

`PasswordCredential`

Browser Support

Source

`navigator.credentials.store()`