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

Cú pháp

URL.parse(url)
URL.parse(url, base)

Tham số

url

Một chuỗi hoặc bất kỳ đối tượng nào khác có stringifier đại diện cho một URL tuyệt đối hoặc một tham chiếu tương đối tới một URL. Nếu url là một tham chiếu tương đối, base là bắt buộc, và được dùng để phân giải URL cuối cùng. Nếu url là một URL tuyệt đối, base được cung cấp sẽ không được dùng để tạo URL kết quả.

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.

Khi bạn chỉ định một URL base, URL được phân giải không chỉ đơn giản là nối url và base. Các tham chiếu tương đối tới thư mục cha và thư mục hiện tại được phân giải tương đối với thư mục hiện tại của URL base, bao gồm chỉ các đoạn đường dẫn cho tới dấu gạch chéo cuối cùng, nhưng không bao gồm những phần sau đó. Các tham chiếu tương đối tới gốc được phân giải tương đối với origin của base. Để biết thêm thông tin, xem Phân giải các tham chiếu tương đối tới một URL.

Giá trị trả về

Một URL nếu các tham số có thể được phân giải thành URL hợp lệ; null nếu không.

Ví dụ

Phân giải các tham chiếu tương đối tới một URL và URL() constructor cung cấp thêm ví dụ minh họa cách các giá trị url và base khác nhau được phân giải thành một URL tuyệt đối cuối cùng (dù chủ yếu dùng URL()).

Cách dùng URL.parse()

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

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

#log {
  height: 100px;
  overflow: scroll;
  padding: 0.5rem;
  border: 1px solid black;
}

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

Trước hết chúng ta kiểm tra xem phương thức URL.parse() có được hỗ trợ hay không bằng điều kiện "parse" in URL. Nếu phương thức được hỗ trợ, chúng ta ghi lại kết quả của việc kiểm tra một URL tuyệt đối, một tham chiếu tương đối và một URL cơ sở, một tham chiếu tương đối với một URL cơ sở phức tạp hơn, một URL tuyệt đối hợp lệ với một URL cơ sở hợp lệ (không được dùng), và một URL cơ sở không hợp lệ dẫn đến việc phương thức trả về null.

Chúng ta cũng ghi lại trường hợp URL.parse() không được hỗ trợ.

if ("parse" in URL) {
  // URL tuyệt đối
  let result = URL.parse("https://mdn.go-mizu.dev/en-US/docs");
  log(`[1]: ${result.href}`);

  // Tham chiếu tương đối tới một URL cơ sở hợp lệ
  result = URL.parse("en-US/docs", "https://mdn.go-mizu.dev");
  log(`[2]: ${result.href}`);

  // Tham chiếu tương đối tới một URL cơ sở hợp lệ "phức tạp"
  // (chỉ scheme và domain được dùng để phân giải url)
  result = URL.parse(
    "/different/place",
    "https://mdn.go-mizu.dev:443/some/path?id=4",
  );
  log(`[3]: ${result.href}`);

  // Đối số URL tuyệt đối (bỏ qua URL cơ sở)
  result = URL.parse(
    "https://example.org/some/docs",
    "https://mdn.go-mizu.dev",
  );
  log(`[4]: ${result.href}`);

  // URL cơ sở không hợp lệ (thiếu dấu hai chấm)
  result = URL.parse("en-US/docs", "https//developer.mozilla.org");
  log(`[5]: ${result}`);
} else {
  log("URL.parse() not supported");
}

Cuối cùng, đoạn mã dưới đây minh họa rằng các đối số không nhất thiết phải là chuỗi, bằng cách truyền một đối tượng URL cho tham số base.

if ("parse" in URL) {
  // Tham chiếu tương đối với URL cơ sở được cung cấp dưới dạng đối tượng URL
  result = URL.parse("/en-US/docs", new URL("https://mdn.go-mizu.dev/"));
  log(`[6]: ${result.href}`);
}

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() constructor, một lựa chọn thay thế không ném lỗi nếu các tham số xác định một URL không hợp lệ
• Polyfill của URL.parse() có sẵn trong core-js