本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
CloudFront Functions JavaScript 執行期環境符合 ECMAScript (ES) 版本 5.1
下列主題列出所有支援的語言功能。
核心功能
支援 ES 的以下核心功能。
- 類型
-
支援所有 ES 5.1 類型。這包括布林值、數字、字串、物件、陣列、函數、函數建構子和常規表達式。
- 運算子
-
支援所有 ES 5.1 運算子。
支援 ES 7 指數運算子 (
**)。 - 聲明
-
注意
不支援
const和let陳述式。支援下列 ES 5.1 陳述式：
-
break -
catch -
continue -
do-while -
else -
finally -
for -
for-in -
if -
return -
switch -
throw -
try -
var -
while -
標記的陳述式
-
- 文字
-
支援 ES 6 範本文字：多行字串、表達式插補和巢狀範本。
- 函數
-
支援所有 ES 5.1 函數功能。
支援 ES 6 箭頭函數，支援 ES 6 剩餘參數語法。
- Unicode
-
來源文字和字串常值可以包含 Unicode 編碼的字元。也支援由六個字元 (例如
\uXXXX) 組成的 Unicode 字碼指標逸出序列。 - 嚴格模式
-
函數按預設會在嚴格模式下運作，因此您不需要在函數程式碼中新增
use strict陳述式。無法對此進行變更。
基本物件
支援 ES 的以下基本物件。
- 物件
-
支援物件上的以下 ES 5.1 方法：
-
create( 不含屬性清單) -
defineProperties -
defineProperty -
freeze -
getOwnPropertyDescriptor -
getOwnPropertyNames -
getPrototypeOf -
hasOwnProperty -
isExtensible -
isFrozen -
prototype.isPrototypeOf -
isSealed -
keys -
preventExtensions -
prototype.propertyIsEnumerable -
seal -
prototype.toString -
prototype.valueOf
支援物件上的以下 ES 6 方法：
-
assign -
is -
prototype.setPrototypeOf
支援物件上的以下 ES 8 方法：
-
entries -
values
-
- 字串
-
支援以下針對字串的 ES 5.1 方法：
-
fromCharCode -
prototype.charAt -
prototype.concat -
prototype.indexOf -
prototype.lastIndexOf -
prototype.match -
prototype.replace -
prototype.search -
prototype.slice -
prototype.split -
prototype.substr -
prototype.substring -
prototype.toLowerCase -
prototype.trim -
prototype.toUpperCase
支援字串上的以下 ES 6 方法：
-
fromCodePoint -
prototype.codePointAt -
prototype.endsWith -
prototype.includes -
prototype.repeat -
prototype.startsWith
支援字串上的以下 ES 8 方法：
-
prototype.padStart -
prototype.padEnd
支援字串上的以下 ES 9 方法：
-
prototype.trimStart -
prototype.trimEnd
支援字串上的以下非標準方法：
-
prototype.bytesFrom(array | string, encoding)從八位元陣列或編碼字串建立一個位元組字串。字串編碼選項為
hex、base64和base64url。 -
prototype.fromBytes(start[, end])從位元組字串建立 Unicode 字串，其中每個位元組都會以對應的 Unicode 字碼指標取代。
-
prototype.fromUTF8(start[, end])從 UTF-8 編碼的位元組字串建立一個 Unicode 字串。如果編碼不正確，則返回
null。 -
prototype.toBytes(start[, end])從 Unicode 字串建立一個位元組字串。所有字元均必須在 [0,255] 範圍內。如果不在此範圍內，則返回
null。 -
prototype.toUTF8(start[, end])從一個 Unicode 字串建立一個 UTF-8 編碼的位元組字串。
-
- 數字
-
支援數字上的所有 ES 5.1 方法。
支援數字上的以下 ES 6 方法：
-
isFinite -
isInteger -
isNaN -
isSafeInteger -
parseFloat -
parseInt -
prototype.toExponential -
prototype.toFixed -
prototype.toPrecision -
EPSILON -
MAX_SAFE_INTEGER -
MAX_VALUE -
MIN_SAFE_INTEGER -
MIN_VALUE -
NEGATIVE_INFINITY -
NaN -
POSITIVE_INFINITY
-
內建物件
支援 ES 的以下內建物件。
- 數學
-
支援所有 ES 5.1 數學方法。
注意
在 CloudFront Functions 執行時間環境中，
Math.random()實作會使用植入函數執行時間戳記的 OpenBSDarc4random。支援以下 ES 6 數學方法：
-
acosh -
asinh -
atanh -
cbrt -
clz32 -
cosh -
expm1 -
fround -
hypot -
imul -
log10 -
log1p -
log2 -
sign -
sinh -
tanh -
trunc -
E -
LN10 -
LN2 -
LOG10E -
LOG2E -
PI -
SQRT1_2 -
SQRT2
-
- 日期
-
支援所有 ES 5.1
Date功能。注意
基於安全考量，在單一函數執行的生命週期內，
Date始終返回相同的值 (函數的開始時間)。如需詳細資訊，請參閱 限制功能。 - 函數
-
支援
apply、bind和call方法。不支援函數建構子。
- 常規表達式
-
支援所有 ES 5.1 常規表達式功能。常規表達式語言與 Perl 相容。支援 ES 9 命名的擷取群組。
- JSON
-
支援所有 ES 5.1 JSON 功能，包括
parse和stringify。 - Array
-
支援陣列上的以下 ES 5.1 方法：
-
isArray -
prototype.concat -
prototype.every -
prototype.filter -
prototype.forEach -
prototype.indexOf -
prototype.join -
prototype.lastIndexOf -
prototype.map -
prototype.pop -
prototype.push -
prototype.reduce -
prototype.reduceRight -
prototype.reverse -
prototype.shift -
prototype.slice -
prototype.some -
prototype.sort -
prototype.splice -
prototype.unshift
支援陣列上的以下 ES 6 方法：
-
of -
prototype.copyWithin -
prototype.fill -
prototype.find -
prototype.findIndex
支援陣列上的以下 ES 7 方法：
-
prototype.includes
-
- 類型陣列
-
支援以下 ES 6 類型陣列：
-
Int8Array -
Uint8Array -
Uint8ClampedArray -
Int16Array -
Uint16Array -
Int32Array -
Uint32Array -
Float32Array -
Float64Array -
prototype.copyWithin -
prototype.fill -
prototype.join -
prototype.set -
prototype.slice -
prototype.subarray -
prototype.toString
-
- 陣列緩衝區
-
支援
ArrayBuffer上的以下方法：-
prototype.isView -
prototype.slice
-
- Promise
-
支援 Promise 上的以下方法：
-
reject -
resolve -
prototype.catch -
prototype.finally -
prototype.then
-
- 加密
-
密碼編譯模組提供標準雜湊和雜湊型訊息身分驗證碼 (HMAC) 協助程式。您可以使用
require('crypto')加載模組。此模組會公開下列方法，其行為與 Node.js 對應方法完全相同：-
createHash(algorithm) -
hash.update(data) -
hash.digest([encoding]) -
createHmac(algorithm, secret key) -
hmac.update(data) -
hmac.digest([encoding])
如需詳細資訊，請參閱內建模組一節中的 加密 (雜湊和 HMAC)。
-
- 主控台
-
這是一個用於偵錯的協助程式物件。它僅支援
log()方法以記錄日誌訊息。注意
CloudFront Functions 不支援逗號語法，例如
console.log('a', 'b')。請改用console.log('a' + ' ' + 'b')格式。
錯誤類型
支援以下錯誤物件：
-
Error -
EvalError -
InternalError -
MemoryError -
RangeError -
ReferenceError -
SyntaxError -
TypeError -
URIError
全域變數
支援 globalThis 物件。
支援以下 ES 5.1 全局函數：
-
decodeURI -
decodeURIComponent -
encodeURI -
encodeURIComponent -
isFinite -
isNaN -
parseFloat -
parseInt
支援以下全局常數：
-
NaN -
Infinity -
undefined
內建模組
支援以下內建模組：
加密 (雜湊和 HMAC)
密碼編譯模組 (crypto) 提供標準雜湊和雜湊型訊息身分驗證碼 (HMAC) 協助程式。您可以使用 require('crypto') 加載模組。此模組提供下列方法，其行為與 Node.js 對應方法完全相同：
雜湊方法
crypto.createHash(algorithm)-
建立並傳回雜湊物件，藉助此物件，您可以使用給定的演算法產生雜湊摘要：
md5、sha1或sha256。 hash.update(data)-
使用給定的
data更新雜湊內容。 hash.digest([encoding])-
計算使用
hash.update()傳遞的所有資料的摘要。編碼可以是hex、base64或base64url。
HMAC 方法
crypto.createHmac(algorithm, secret key)-
建立並返回使用給定
algorithm和secret key的 HMAC 物件。演算法可以是md5、sha1或sha256。 hmac.update(data)-
使用給定的
data更新 HMAC 內容。 hmac.digest([encoding])-
計算使用
hmac.update()傳遞的所有資料的摘要。編碼可以是hex、base64或base64url。
查詢字串
注意
CloudFront Functions 事件物件會自動剖析 URL 查詢字串。這意味著在大多數情況下，您不需要使用此模組。
查詢字串模組 (querystring) 提供剖析和格式化 URL 查詢字串的方法。您可以使用 require('querystring') 加載模組。此模組提供下列方法。
querystring.escape(string)-
URL 編碼給定的
string，傳回逸出的查詢字串。該方法由querystring.stringify()使用，並且不應直接使用。 querystring.parse(string[, separator[, equal[, options]]])-
剖析查詢字串 (
string) 並傳回物件。separator參數是用來分隔查詢字串中的鍵/值對的子字串。其在預設情況下為&。equal參數是用來分隔查詢字串中的鍵和值的子字串。其在預設情況下為=。options參數是具有下列鍵的物件：decodeURIComponent function-
解碼查詢字串中百分比編碼字元的函數。其在預設情況下為
querystring.unescape()。 maxKeys number-
要剖析的鍵的最大數量。其在預設情況下為
1000。使用0的值移除計數鍵的限制。
根據預設，查詢字串中的百分比編碼字元會假設為使用 UTF-8 編碼。無效的 UTF-8 序列會被取代為
U+FFFD取代字元。例如，對於下列查詢字串：
'name=value&abc=xyz&abc=123'querystring.parse()的返回值是：{ name: 'value', abc: ['xyz', '123'] }querystring.decode()是 的別名。querystring.parse() querystring.stringify(object[, separator[, equal[, options]]])-
序列化
object並傳回查詢字串。separator參數是用來分隔查詢字串中的鍵/值對的子字串。其在預設情況下為&。equal參數是用來分隔查詢字串中的鍵和值的子字串。其在預設情況下為=。options參數是具有下列鍵的物件：encodeURIComponent function-
用於將 URL 不安全字元轉換為查詢字串中的百分比編碼的函數。其在預設情況下為
querystring.escape()。
根據預設，在查詢字串中需要百分比編碼的字元會編碼為 UTF-8。若要使用不同的編碼，請指定
encodeURIComponent選項。例如，對於以下程式碼：
querystring.stringify({ name: 'value', abc: ['xyz', '123'], anotherName: '' });返回值是：
'name=value&abc=xyz&abc=123&anotherName='querystring.encode()是querystring.stringify()的別名。 querystring.unescape(string)-
解碼給定
string中的 URL 百分比編碼字元，傳回未逸出的查詢字串。此方法由querystring.parse()使用，並且不應直接使用。
限制功能
由於安全考量，下列 JavaScript 語言功能不受支援或受到限制。
- 動態程式碼評估
-
不支援動態程式碼評估。如果嘗試此評估，
eval()和Function建構子都會丟出錯誤。例如，const sum = new Function('a', 'b', 'return a + b')丟出錯誤。 - 計時器
-
不支援
setTimeout()、setImmediate()和clearTimeout()函數。在函數執行期間未推遲或產生任何佈建。您的函數必須同步執行方可完成。 - 日期和時間戳記
-
基於安全考量，無法存取高解析度計時器。查詢當前時間的所有
Date方法始終在單個函數執行的生命週期內返回相同的值。返回的時間戳記是函數開始執行的時間。因此，您無法測量函數中的經過時間。 - 檔案系統存取
-
沒有檔案系統存取權。例如，沒有類似 Node.js 中的檔案系統存取
fs模組。 - 程序存取
-
沒有程序存取。例如，沒有
process全域物件可處理資訊存取，就像 Node.js 中一樣。 - 環境變數
-
無法存取環境變數。
反之，您可以使用 CloudFront KeyValueStore 為您的 CloudFront Functions 建立金鑰值對的集中式資料存放區。CloudFront KeyValueStore 啟用組態資料的動態更新，而不需要部署程式碼變更。您必須使用 JavaScript 執行期 2.0 才能使用 CloudFront KeyValueStore。如需詳細資訊，請參閱Amazon CloudFront KeyValueStore。
- 網路存取
-
不支援網路呼叫。例如，不支援 XHR、HTTP(S) 和通訊端。
