Giới thiệu về hàm tìm nạp()

fetch() cho phép bạn đưa ra các yêu cầu mạng tương tự như XMLHttpRequest (XHR). Điểm khác biệt chính là API Tìm nạp sử dụng Lời hứa, trong đó có API đơn giản hơn để giúp bạn tránh các lệnh gọi lại phức tạp trong API XMLHttpRequest.

Hỗ trợ trình duyệt

  • Chrome: 42.
  • Edge: 14.
  • Firefox: 39.
  • Safari: 10.1.

Nguồn

Nếu trước đây bạn chưa từng sử dụng Promises (Lời hứa), hãy xem phần Giới thiệu về JavaScript Promises.

Dưới đây là một ví dụ được triển khai bằng XMLHttpRequest, sau đó triển khai bằng fetch. Chúng ta muốn yêu cầu một URL, nhận phản hồi và phân tích cú pháp phản hồi đó dưới dạng JSON.

XMLHttpRequest

XMLHttpRequest cần hai trình nghe để xử lý các trường hợp thành công và lỗi, cũng như một lệnh gọi đến open()send(). Ví dụ trong tài liệu về MDN.

function reqListener () {
  const data = JSON.parse(this.responseText);
  console.log(data);
}

function reqError (err) {
  console.log('Fetch Error :-S', err);
}

const oReq = new XMLHttpRequest();
oReq.onload = reqListener;
oReq.onerror = reqError;
oReq.open('get', './api/some.json', true);
oReq.send();

Tìm nạp

Yêu cầu tìm nạp của chúng ta có dạng như sau:

fetch('./api/some.json')
  .then(response => {
    if (response.status !== 200) {
      console.log(`Looks like there was a problem. Status Code: ${response.status}`);

      return;
    }

    // Examine the text in the response
    response.json().then(function(data) {
      console.log(data);
    });
  })
  .catch(err => {
    console.log('Fetch Error :-S', err);
  });

Yêu cầu fetch() chỉ cần một lệnh gọi để thực hiện công việc tương tự như ví dụ XHR. Để xử lý phản hồi, trước tiên, chúng ta kiểm tra để đảm bảo trạng thái phản hồi là 200, sau đó phân tích cú pháp phản hồi dưới dạng JSON. Phản hồi cho yêu cầu fetch() là đối tượng Stream (Luồng), có nghĩa là sau khi chúng ta gọi phương thức json(), Promise sẽ được trả về. Luồng diễn ra không đồng bộ.

Siêu dữ liệu về câu trả lời

Ví dụ trước đã cho thấy trạng thái của đối tượng Phản hồi và cách phân tích cú pháp phản hồi dưới dạng JSON. Sau đây là cách xử lý siêu dữ liệu khác mà bạn có thể muốn truy cập, chẳng hạn như tiêu đề:

fetch('users.json').then(response => {
  console.log(response.headers.get('Content-Type'));
  console.log(response.headers.get('Date'));

  console.log(response.status);
  console.log(response.statusText);
  console.log(response.type);
  console.log(response.url);
});

Loại phản hồi

Khi chúng ta thực hiện một yêu cầu tìm nạp, phản hồi sẽ được cung cấp một response.type là "basic", "cors" hoặc "opaque". Các types này cho biết nguồn gốc của tài nguyên và bạn có thể sử dụng các types này để xác định cách xử lý đối tượng phản hồi.

Khi trình duyệt yêu cầu tài nguyên trên cùng một nguồn gốc, phản hồi sẽ có loại basic có các hạn chế về nội dung bạn có thể xem từ phản hồi.

Nếu bạn gửi yêu cầu cho một tài nguyên trên một nguồn gốc khác và nguồn đó trả về tiêu đề COR, thì loại sẽ là cors. Phản hồi cors tương tự như phản hồi basic, nhưng giới hạn các tiêu đề bạn có thể xem ở Cache-Control, Content-Language, Content-Type, Expires, Last-ModifiedPragma.

Phản hồi opaque đến từ một nguồn gốc khác không trả về tiêu đề CORS. Với phản hồi mờ, chúng tôi sẽ không thể đọc dữ liệu được trả về hoặc xem trạng thái của yêu cầu, nghĩa là bạn không thể kiểm tra xem yêu cầu có thành công hay không.

Bạn có thể xác định chế độ cho yêu cầu tìm nạp để chỉ một số loại yêu cầu nhất định được phân giải. Sau đây là các chế độ bạn có thể đặt:

  • same-origin chỉ thành công đối với các yêu cầu tài sản trên cùng một nguồn gốc và từ chối mọi yêu cầu khác.
  • cors cho phép các yêu cầu đối với các thành phần trên cùng một nguồn gốc và các nguồn gốc khác trả về tiêu đề CORS thích hợp.
  • cors-with-forced-preflight thực hiện kiểm tra trước khi bay trước khi thực hiện bất kỳ yêu cầu nào.
  • no-cors dùng để đưa ra yêu cầu cho các nguồn gốc khác không có tiêu đề CORS và dẫn đến phản hồi opaque, nhưng như đã nói , hiện tại bạn không thể thực hiện việc này ở phạm vi toàn cục của cửa sổ.

Để xác định chế độ, hãy thêm một đối tượng tuỳ chọn làm tham số thứ hai trong yêu cầu fetch và xác định chế độ trong đối tượng đó:

fetch('http://some-site.com/cors-enabled/some.json', {mode: 'cors'})
  .then(response => response.text())
  .then(text => {
    console.log('Request successful', text);
  })
  .catch(error => {
    log('Request failed', error)
  });

Chuỗi hứa hẹn

Một trong những tính năng tuyệt vời của lời hứa là khả năng liên kết các lời hứa với nhau. Đối với fetch(), điều này cho phép bạn chia sẻ logic trên các yêu cầu tìm nạp.

Nếu đang làm việc với một API JSON, bạn cần kiểm tra trạng thái và phân tích cú pháp JSON cho từng phản hồi. Bạn có thể đơn giản hoá mã bằng cách xác định trạng thái và phân tích cú pháp JSON trong các hàm riêng biệt trả về các lời hứa, đồng thời sử dụng yêu cầu tìm nạp để chỉ xử lý dữ liệu cuối cùng và trường hợp lỗi.

function status (response) {
  if (response.status >= 200 && response.status < 300) {
    return Promise.resolve(response)
  } else {
    return Promise.reject(new Error(response.statusText))
  }
}

function json (response) {
  return response.json()
}

fetch('users.json')
  .then(status)
  .then(json)
  .then(data => {
    console.log('Request succeeded with JSON response', data);
  }).catch(error => {
    console.log('Request failed', error);
  });

Ví dụ này xác định một hàm status kiểm tra response.status và trả về một Lời hứa đã được giải quyết dưới dạng Promise.resolve() hoặc một Lời hứa bị từ chối dưới dạng Promise.reject(). Đây là phương thức đầu tiên được gọi trong chuỗi fetch().

Nếu Promise được phân giải, thì tập lệnh sẽ gọi phương thức json(). Phương thức này trả về Promise thứ hai từ lệnh gọi response.json() và tạo một đối tượng chứa JSON đã phân tích cú pháp. Nếu không phân tích cú pháp được, Lời hứa sẽ bị từ chối và câu lệnh catch sẽ thực thi.

Cấu trúc này cho phép bạn chia sẻ logic trên tất cả các yêu cầu tìm nạp, giúp duy trì, đọc và kiểm thử mã dễ dàng hơn.

Yêu cầu POST

Đôi khi, ứng dụng web cần gọi một API bằng phương thức POST và đưa một số tham số vào nội dung của yêu cầu. Để làm điều này, hãy đặt tham số methodbody trong các tuỳ chọn fetch():

fetch(url, {
    method: 'post',
    headers: {
      "Content-type": "application/x-www-form-urlencoded; charset=UTF-8"
    },
    body: 'foo=bar&lorem=ipsum'
  })
  .then(json)
  .then(data => {
    console.log('Request succeeded with JSON response', data);
  })
  .catch(error => {
    console.log('Request failed', error);
  });

Gửi thông tin xác thực bằng yêu cầu tìm nạp

Để thực hiện yêu cầu tìm nạp bằng các thông tin xác thực như cookie, hãy đặt giá trị credentials của yêu cầu thành "include":

fetch(url, {
  credentials: 'include'
})