HTML chưa được dọn dẹp trong API Bảng nhớ tạm không đồng bộ

Kể từ Chrome 120, một tuỳ chọn unsanitized mới sẽ có trong Async Clipboard API. Lựa chọn này có thể giúp ích trong các trường hợp đặc biệt với HTML, khi bạn cần dán nội dung của bảng nhớ tạm giống hệt như khi sao chép. Tức là không có bất kỳ bước dọn dẹp trung gian nào mà trình duyệt thường áp dụng (và có lý do chính đáng). Tìm hiểu cách sử dụng tính năng này trong hướng dẫn sau đây.

Khi làm việc với Async Clipboard API, trong hầu hết các trường hợp, nhà phát triển không cần lo lắng về tính toàn vẹn của nội dung trên bảng nhớ tạm và có thể giả định rằng nội dung họ ghi vào bảng nhớ tạm (sao chép) giống với nội dung họ sẽ nhận được khi đọc dữ liệu từ bảng nhớ tạm (dán).

Điều này chắc chắn đúng với văn bản. Hãy thử dán mã sau vào Bảng điều khiển DevTools rồi lấy lại tiêu điểm cho trang ngay lập tức. (setTimeout() là cần thiết để bạn có đủ thời gian tập trung vào trang, đây là yêu cầu của Async Clipboard API.) Như bạn thấy, dữ liệu đầu vào giống hệt dữ liệu đầu ra.

setTimeout(async () => {
  const input = 'Hello';
  await navigator.clipboard.writeText(input);
  const output = await navigator.clipboard.readText();
  console.log(input, output, input === output);
  // Logs "Hello Hello true".
}, 3000);

Với hình ảnh, quy trình sẽ hơi khác một chút. Để ngăn chặn các cuộc tấn công được gọi là bom nén, trình duyệt sẽ mã hoá lại hình ảnh như PNG, nhưng hình ảnh đầu vào và đầu ra về mặt hình ảnh hoàn toàn giống nhau, từng pixel một.

setTimeout(async () => {
  const dataURL =
    'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVQYV2NgYAAAAAMAAWgmWQ0AAAAASUVORK5CYII=';
  const input = await fetch(dataURL).then((response) => response.blob());
  await navigator.clipboard.write([
    new ClipboardItem({
      [input.type]: input,
    }),
  ]);
  const [clipboardItem] = await navigator.clipboard.read();
  const output = await clipboardItem.getType(input.type);
  console.log(input.size, output.size, input.type === output.type);
  // Logs "68 161 true".
}, 3000);

Tuy nhiên, điều gì sẽ xảy ra với văn bản HTML? Như bạn có thể đoán, với HTML, tình hình sẽ khác. Tại đây, trình duyệt sẽ dọn dẹp mã HTML để ngăn chặn những điều xấu xảy ra, chẳng hạn như bằng cách loại bỏ các thẻ <script> khỏi mã HTML (và các thẻ khác như <meta>, <head> và <style>) và bằng cách chèn CSS. Hãy xem ví dụ sau và thử trong Bảng điều khiển Công cụ cho nhà phát triển. Bạn sẽ nhận thấy kết quả đầu ra khác biệt đáng kể so với dữ liệu đầu vào.

setTimeout(async () => {
  const input = `<html>  
  <head>  
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />  
    <meta name="ProgId" content="Excel.Sheet" />  
    <meta name="Generator" content="Microsoft Excel 15" />  
    <style>  
      body {  
        font-family: HK Grotesk;  
        background-color: var(--color-bg);  
      }  
    </style>  
  </head>  
  <body>  
    <div>hello</div>  
  </body>  
</html>`;
  const inputBlob = new Blob([input], { type: 'text/html' });
  await navigator.clipboard.write([
    new ClipboardItem({
      'text/html': inputBlob,
    }),
  ]);
  const [clipboardItem] = await navigator.clipboard.read();
  const outputBlob = await clipboardItem.getType('text/html');
  const output = await outputBlob.text();
  console.log(input, output);
}, 3000);

Nhìn chung, việc dọn dẹp HTML là một điều nên làm. Bạn không nên để bản thân gặp phải các vấn đề bảo mật bằng cách cho phép HTML chưa được dọn dẹp trong hầu hết các trường hợp. Tuy nhiên, có những trường hợp nhà phát triển biết chính xác những gì họ đang làm và tính toàn vẹn của HTML đầu vào và đầu ra là yếu tố quan trọng để ứng dụng hoạt động đúng cách. Trong những trường hợp này, bạn có hai lựa chọn:

  1. Nếu bạn kiểm soát cả việc sao chép và dán, ví dụ: nếu bạn sao chép từ trong ứng dụng rồi dán vào ứng dụng, thì bạn nên sử dụng Định dạng tuỳ chỉnh trên web cho Async Clipboard API. Hãy dừng đọc tại đây và xem bài viết được liên kết.
  2. Nếu bạn chỉ kiểm soát thao tác dán trong ứng dụng chứ không kiểm soát thao tác sao chép (có thể là do thao tác sao chép diễn ra trong một ứng dụng gốc không hỗ trợ định dạng tuỳ chỉnh trên web), thì bạn nên sử dụng tuỳ chọn unsanitized, được giải thích trong phần còn lại của bài viết này.

Hoạt động dọn dẹp bao gồm những việc như xoá thẻ script, tạo kiểu cùng dòng và đảm bảo HTML có định dạng hợp lệ. Danh sách này chưa đầy đủ và có thể sẽ có thêm các bước khác trong tương lai.

Sao chép và dán HTML chưa được dọn dẹp

Khi bạn write() (sao chép) HTML vào bảng nhớ tạm bằng Async Clipboard API, trình duyệt sẽ đảm bảo rằng HTML được định dạng đúng bằng cách chạy HTML thông qua trình phân tích cú pháp DOM và chuyển đổi chuỗi HTML thu được thành chuỗi tuần tự, nhưng không có quá trình dọn dẹp nào diễn ra ở bước này. Bạn không cần làm gì cả. Khi bạn read() HTML được một ứng dụng khác đặt vào bảng nhớ tạm và ứng dụng web của bạn chọn nhận nội dung có độ chân thực đầy đủ và cần thực hiện bất kỳ quy trình dọn dẹp nào trong mã của riêng bạn, bạn có thể truyền một đối tượng tuỳ chọn đến phương thức read() có thuộc tính unsanitized và giá trị là ['text/html']. Khi tách riêng, lệnh này sẽ có dạng như sau: navigator.clipboard.read({ unsanitized: ['text/html'] }). Mã mẫu sau đây gần giống với mã mẫu được trình bày trước đó, nhưng lần này có tuỳ chọn unsanitized. Khi thử trong Bảng điều khiển Công cụ cho nhà phát triển, bạn sẽ thấy dữ liệu đầu vào và đầu ra giống nhau.

setTimeout(async () => {
  const input = `<html>  
  <head>  
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />  
    <meta name="ProgId" content="Excel.Sheet" />  
    <meta name="Generator" content="Microsoft Excel 15" />  
    <style>  
      body {  
        font-family: HK Grotesk;  
        background-color: var(--color-bg);  
      }  
    </style>  
  </head>  
  <body>  
    <div>hello</div>  
  </body>  
</html>`;
  const inputBlob = new Blob([input], { type: 'text/html' });
  await navigator.clipboard.write([
    new ClipboardItem({
      'text/html': inputBlob,
    }),
  ]);
  const [clipboardItem] = await navigator.clipboard.read({
    unsanitized: ['text/html'],
  });
  const outputBlob = await clipboardItem.getType('text/html');
  const output = await outputBlob.text();
  console.log(input, output);
}, 3000);

Hỗ trợ trình duyệt và phát hiện tính năng

Không có cách trực tiếp nào để kiểm tra xem tính năng này có được hỗ trợ hay không, vì vậy, việc phát hiện tính năng sẽ dựa trên việc quan sát hành vi. Do đó, ví dụ sau đây dựa trên việc phát hiện xem thẻ <style> có tồn tại hay không (cho biết có hỗ trợ) hay đang được chèn cùng dòng (cho biết không hỗ trợ). Xin lưu ý rằng để tính năng này hoạt động, trang đã cần phải có quyền truy cập vào bảng nhớ tạm.

const supportsUnsanitized = async () => {
  const input = `<style>p{color:red}</style><p>a`;
  const inputBlob = new Blob([input], { type: 'text/html' });
  await navigator.clipboard.write([
    new ClipboardItem({
      'text/html': inputBlob,
    }),
  ]);
  const [clipboardItem] = await navigator.clipboard.read({
    unsanitized: ['text/html'],
  });
  const outputBlob = await clipboardItem.getType('text/html');
  const output = await outputBlob.text();
  return /<style>/.test(output);
};

Bản minh hoạ

Để xem cách hoạt động của tuỳ chọn unsanitized, hãy xem bản minh hoạ và xem mã nguồn của tuỳ chọn này.

Kết luận

Như đã nêu trong phần giới thiệu, hầu hết nhà phát triển sẽ không bao giờ cần phải lo lắng về việc dọn dẹp bảng nhớ tạm và chỉ có thể làm việc với các lựa chọn dọn dẹp mặc định do trình duyệt thực hiện. Trong một số ít trường hợp mà nhà phát triển cần quan tâm, bạn có thể dùng tuỳ chọn unsanitized.

Xác nhận

Bài viết này đã được Anupam Snigdha và Rachel Andrew xem xét. API này do nhóm Microsoft Edge chỉ định và triển khai.