如何使用Browser.js SDK預覽和下載檔案 - Object Storage Service

在瀏覽器中使用signatureUrl方法產生用於預覽或下載的檔案URL。您可以通過HTML中<a>標籤的download屬性、Web API中的window.open等方式使用擷取的檔案URL。

注意事項

當您使用webpack或browserify等打包工具時，請通過npm install ali-oss的方式安裝Browser.js SDK。
通過瀏覽器訪問OSS時涉及跨域請求，如果未設定跨域規則，瀏覽器會拒絕跨域訪問請求。如果您希望通過瀏覽器可以正常訪問OSS，需要通過OSS設定跨域規則。具體操作，請參見準備工作。
由於Browser.js SDK通常在瀏覽器環境下使用，為避免暴露阿里雲帳號存取金鑰（AccessKey ID和AccessKey Secret），強烈建議您使用臨時訪問憑證的方式執行OSS相關操作。
臨時訪問憑證包括臨時存取金鑰（AccessKey ID和AccessKey Secret）和安全性權杖（SecurityToken）。擷取臨時訪問憑證的具體操作，請參見授權訪問。

擷取檔案的預覽URL

以下代碼用於擷取examplebucket中exampleobject.txt檔案的預覽URL。

說明

如果您要直接在瀏覽器中預覽檔案，請設定檔案HTTP頭中的Content-Disposition為inline並使用Bucket綁定的自訂網域名進行訪問。具體操作，請分別參見設定檔案元資訊和使用自訂網域名。

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="UTF-8" />
    <title>Document</title>
  </head>

  <body>
    <!--匯入SDK檔案-->
    <script
      type="text/javascript"
      src="https://gosspublic.alicdn.com/aliyun-oss-sdk-6.18.0.min.js"
    ></script>
    <script type="text/javascript">
      const client = new OSS({
        // yourRegion填寫Bucket所在地區。以華東1（杭州）為例，Region填寫為oss-cn-hangzhou。
        region: "yourRegion",
        authorizationV4: true,
        // 從STS服務擷取的臨時存取金鑰（AccessKey ID和AccessKey Secret）。
        accessKeyId: "yourAccessKeyId",
        accessKeySecret: "yourAccessKeySecret",
        // 從STS服務擷取的安全性權杖（SecurityToken）。
        stsToken: "yoursecurityToken",
        // 填寫Bucket名稱。
        bucket: "examplebucket",
      });
      
      // 填寫Object完整路徑。Object完整路徑中不能包含Bucket名稱。
      const url = client.signatureUrl("example.jpg", {
        // 如果您希望產生的簽名URL可以應用圖片樣式的效果，您可以通過process參數指定樣式，格式為style/樣式名稱。
        // process: "style/imagestyle",
      });
      console.log(url);

      // 設定URL的有效時間長度。單位為秒。如果不設定有效時間長度，則預設為1800。
      // url = client.signatureUrl('example.jpg', {expires: 3600});
      // console.log(url);
    </script>
  </body>
</html>

擷取檔案的下載URL

以下代碼用於擷取examplebucket中exampleobject.txt檔案的下載URL。URL的有效時間長度預設為1800秒。

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="UTF-8" />
    <title>Document</title>
  </head>

  <body>
    <!--匯入SDK檔案-->
    <script
      type="text/javascript"
      src="https://gosspublic.alicdn.com/aliyun-oss-sdk-6.18.0.min.js"
    ></script>
    <script type="text/javascript">
      const client = new OSS({
        // yourRegion填寫Bucket所在地區。以華東1（杭州）為例，Region填寫為oss-cn-hangzhou。
        region: "yourRegion",
        authorizationV4: true,
        // 從STS服務擷取的臨時存取金鑰（AccessKey ID和AccessKey Secret）。
        accessKeyId: "yourAccessKeyId",
        accessKeySecret: "yourAccessKeySecret",
        // 從STS服務擷取的安全性權杖（SecurityToken）。
        stsToken: "yoursecurityToken",
        // 填寫Bucket名稱。
        bucket: "examplebucket",
      });

      // 配置回應標頭實現通過URL訪問時自動下載檔案，並設定下載後的檔案名稱。
      const filename = "examplefile.txt";
      const response = {
        "content-disposition": `attachment; filename=${encodeURIComponent(
          filename
        )}`,
      };
      // 填寫Object完整路徑。Object完整路徑中不能包含Bucket名稱。
      const url = client.signatureUrl("exampleobject.txt", { response });
      console.log(url);
    </script>
  </body>
</html>