Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Metode pembantu umum
<a name="general-helper-methods"></a>

Halaman ini menyediakan metode pembantu tambahan di dalam CloudFront Fungsi. Untuk menggunakan metode ini, buat CloudFront fungsi menggunakan JavaScript runtime 2.0.

```
import cf from 'cloudfront';
```

Untuk informasi selengkapnya, lihat [JavaScript fitur runtime 2.0 untuk Fungsi CloudFront](functions-javascript-runtime-20.md).

## `edgeLocation`metadata
<a name="edge-location-metadata"></a>

Metode ini membutuhkan penggunaan `cloudfront` modul.

**catatan**  
Anda hanya dapat menggunakan metode ini untuk fungsi permintaan pemirsa. Untuk fungsi respons pemirsa, metode ini kosong.

Gunakan JavaScript objek ini untuk mendapatkan kode bandara lokasi tepi, wilayah [Regional Edge Cache](HowCloudFrontWorks.md#CloudFrontRegionaledgecaches) yang diharapkan atau alamat IP CloudFront server yang digunakan untuk menangani permintaan. Metadata ini hanya tersedia pemicu peristiwa permintaan penampil.

```
cf.edgeLocation = {
    name: SEA
    serverIp: 1.2.3.4
    region: us-west-2
}
```

`cf.edgeLocation`Objek dapat berisi yang berikut:

**name**  
[Kode IATA](https://en.wikipedia.org/wiki/IATA_airport_code) tiga huruf dari lokasi tepi yang menangani permintaan.

**ServeIP**  
 IPv6 Alamat IPv4 atau server yang menangani permintaan.

**region**  
 CloudFront Regional Edge Cache (REC) yang *diharapkan akan* digunakan permintaan jika ada cache yang hilang. Nilai ini tidak diperbarui jika REC yang diharapkan tidak tersedia dan REC cadangan digunakan untuk permintaan tersebut. Ini tidak termasuk lokasi Origin Shield yang digunakan, kecuali jika REC utama dan Origin Shield berada di lokasi yang sama.

**catatan**  
CloudFront Fungsi tidak dipanggil untuk kedua kalinya ketika CloudFront dikonfigurasi untuk menggunakan failover asal. Untuk informasi selengkapnya, lihat [Optimalkan ketersediaan tinggi dengan failover CloudFront asal](high_availability_origin_failover.md).

## Metode `rawQueryString()`
<a name="raw-query-string-method"></a>

Metode ini tidak memerlukan `cloudFront` modul.

Gunakan `rawQueryString()` metode ini untuk mengambil string kueri yang tidak diurai dan tidak diubah sebagai string.

**Permintaan**

```
function handler(event) {
    var request = event.request;
    const qs = request.rawQueryString();
}
```

**Respons**

Mengembalikan string query lengkap dari permintaan masuk sebagai nilai string tanpa memimpin`?`. 
+ Jika tidak ada string query, tetapi `?` hadir, fungsi mengembalikan string kosong. 
+ Jika tidak ada string kueri dan `?` tidak hadir, fungsi kembali`undefined`.

**Kasus 1: String kueri lengkap dikembalikan (tanpa memimpin`?`)**  
URL permintaan masuk: `https://example.com/page?name=John&age=25&city=Boston`  
`rawQueryString()`mengembalikan: `"name=John&age=25&city=Boston"`

**Kasus 2: String kosong dikembalikan (kapan `?` ada tetapi tanpa parameter)**  
URL permintaan masuk: `https://example.com/page?`  
`rawQueryString()`mengembalikan: `""`

**Kasus 3: `undefined` dikembalikan (tidak ada string kueri dan tidak`?`)**  
URL permintaan masuk: `https://example.com/page`  
`rawQueryString()`mengembalikan: `undefined`