Location: assign() 方法

語法

assign(url)

引數

url

一個字串，或者任何其他具有 字串化器的物件，例如一個 URL 物件，其中包含要導航到的頁面的 URL；例如，絕對 URL，如 https://mdn.club.tw/en-US/docs/Web/API/Location/reload，或者相對 URL — 如 /Web（僅為路徑，用於導航到同一來源的另一個文件）或 #specifications（僅為片段字串，用於導航到同一頁面的某個部分），依此類推。

異常

SecurityError DOMException

如果呼叫該方法的指令碼的 源與 Location 物件最初描述的頁面的 同源策略不一致，則會引發此異常，這通常發生在指令碼託管在不同域時。瀏覽器還會限制導航的頻率，如果呼叫過於頻繁，可能會引發此錯誤、生成警告或忽略該呼叫。

SyntaxError DOMException

如果提供的 url 引數不是有效 URL，則會引發此異常。

返回值

無（undefined）。

示例

// Navigate to the Location.reload article
window.location.assign(
  "https://mdn.club.tw/en-US/docs/Web/API/Location/reload",
);

// Then navigate to its Specifications section
window.location.assign("#specifications");

// Eventually navigate to https://mdn.club.tw/en-US/docs/Web
window.location.assign("/Web");

規範

瀏覽器相容性

另見

• 它所屬的 Location 介面。
• 類似方法：Location.replace() 和 Location.reload()。