URL: phương thức tĩnh canParse()

Cú pháp

URL.canParse(url)
URL.canParse(url, base)

Tham số

url

Một chuỗi hoặc bất kỳ đối tượng nào khác có stringifier - bao gồm, ví dụ, một phần tử <a> hoặc <area> - đại diện cho một URL tuyệt đối hoặc tương đối. Nếu url là một URL tương đối, base là bắt buộc, và sẽ được dùng làm URL cơ sở. Nếu url là một URL tuyệt đối, base được cung cấp sẽ bị bỏ qua.

base Optional

Một chuỗi đại diện cho URL cơ sở dùng trong trường hợp url là một URL tương đối. Nếu không chỉ định, giá trị mặc định là undefined.

Giá trị trả về

true nếu URL có thể được phân tích và hợp lệ; false nếu không.

Ví dụ

Ví dụ trực tiếp này minh họa cách dùng phương thức tĩnh URL.canParse() với một vài giá trị URL tuyệt đối và tương đối khác nhau.

Phần đầu của ví dụ định nghĩa một phần tử HTML <pre> để ghi log, cùng với một phương thức ghi log log().

<pre id="log"></pre>

const logElement = document.getElementById("log");
function log(text) {
  logElement.innerText += `${text}\n`;
}

Tiếp theo chúng ta kiểm tra xem phương thức URL.canParse() có được hỗ trợ hay không bằng điều kiện "canParse" in URL. Nếu phương thức được hỗ trợ, chúng ta ghi lại kết quả kiểm tra một URL tuyệt đối, một URL tương đối không có URL cơ sở, và một URL tương đối với một URL cơ sở hợp lệ. Chúng ta cũng ghi lại trường hợp URL.canParse() không được hỗ trợ.

if ("canParse" in URL) {
  log("Test valid absolute URL");
  let url = "https://mdn.go-mizu.dev/";
  let result = URL.canParse(url);
  log(` URL.canParse("${url}"): ${result}`);

  log("\nTest relative URL with no base URL");
  url = "/en-US/docs";
  result = URL.canParse(url);
  log(` URL.canParse("${url}"): ${result}`);

  log("\nTest relative URL with valid base URL");
  let baseUrl = "https://mdn.go-mizu.dev/";
  result = URL.canParse(url, baseUrl);
  log(` URL.canParse("${url}","${baseUrl}"): ${result}`);
} else {
  log("URL.canParse() không được hỗ trợ");
}

Cuối cùng, đoạn mã dưới đây cho thấy baseUrl không nhất thiết phải là chuỗi. Ở đây chúng ta đã truyền vào một đối tượng URL.

if ("canParse" in URL) {
  log("\nTest relative URL with base URL supplied as a URL object");
  let baseUrl = new URL("https://mdn.go-mizu.dev/");
  let url = "/en-US/docs";
  result = URL.canParse(url, baseUrl);
  log(` URL.canParse("${url}","${baseUrl}"): ${result}`);
}

Kết quả của từng kiểm tra được hiển thị bên dưới.

Thông số kỹ thuật

Tương thích trình duyệt

Xem thêm

• URL()
• Polyfill của URL.canParse() có sẵn trong core-js