Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Allgemeine Hilfsmethoden
<a name="general-helper-methods"></a>

Diese Seite bietet zusätzliche Hilfsmethoden innerhalb von CloudFront Functions. Um diese Methoden zu verwenden, erstellen Sie eine CloudFront Funktion mit JavaScript Runtime 2.0.

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

Weitere Informationen finden Sie unter [Features von JavaScript Runtime 2.0 für CloudFront-Funktionen](functions-javascript-runtime-20.md).

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

Diese Methode erfordert die Verwendung des `cloudfront` Moduls.

**Anmerkung**  
Sie können diese Methode nur für Funktionen verwenden, die von Zuschauern angefordert werden. Für Zuschauer-Antwort-Funktionen ist diese Methode leer.

Verwenden Sie dieses JavaScript Objekt, um den Flughafencode des Edge-Standorts, die erwartete [regionale Edge-Cache-Region](HowCloudFrontWorks.md#CloudFrontRegionaledgecaches) oder die CloudFront Server-IP-Adresse abzurufen, die für die Bearbeitung der Anfrage verwendet wurde. Diese Metadaten sind nur für den Event-Trigger der Viewer-Anforderung verfügbar.

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

Das `cf.edgeLocation` Objekt kann Folgendes enthalten:

**Name**  
Der aus drei Buchstaben bestehende [IATA-Code](https://en.wikipedia.org/wiki/IATA_airport_code) des Edge-Standorts, der die Anfrage bearbeitet hat.

**Server-IP**  
Die IPv6 Adresse IPv4 oder des Servers, der die Anfrage bearbeitet hat.

**Region**  
Der CloudFront Regional Edge Cache (REC), den die Anfrage *voraussichtlich* verwenden wird, wenn ein Cache-Fehler auftritt. Dieser Wert wird nicht aktualisiert, falls der erwartete REC nicht verfügbar ist und ein Backup-REC für die Anfrage verwendet wird. Dies beinhaltet nicht, dass der Origin Shield-Standort verwendet wird, außer in Fällen, in denen sich das primäre REC und das Origin Shield am selben Standort befinden.

**Anmerkung**  
CloudFront Functions wird kein zweites Mal aufgerufen, wenn CloudFront es für die Verwendung von Origin-Failover konfiguriert ist. Weitere Informationen finden Sie unter [Optimieren der Hochverfügbarkeit mit CloudFront Origin Failover](high_availability_origin_failover.md).

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

Für diese Methode ist das Modul nicht erforderlich. `cloudFront`

Verwenden Sie die `rawQueryString()` Methode, um die ungeparste und unveränderte Abfragezeichenfolge als Zeichenfolge abzurufen.

**Anforderung**

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

**Antwort**

Gibt die vollständige Abfragezeichenfolge der eingehenden Anfrage als Zeichenkettenwert ohne den Anfang zurück. `?` 
+ Wenn es keine Abfragezeichenfolge gibt, aber die vorhanden `?` ist, geben die Funktionen eine leere Zeichenfolge zurück. 
+ Wenn es keine Abfragezeichenfolge gibt und die `?` nicht vorhanden ist, gibt die Funktion zurück`undefined`.

**Fall 1: Vollständige Abfragezeichenfolge zurückgegeben (ohne Leerlauf`?`)**  
URL der eingehenden Anfrage: `https://example.com/page?name=John&age=25&city=Boston`  
`rawQueryString()`gibt zurück: `"name=John&age=25&city=Boston"`

**Fall 2: Es wurde eine leere Zeichenfolge zurückgegeben (wenn sie vorhanden `?` ist, aber ohne Parameter)**  
URL der eingehenden Anfrage: `https://example.com/page?`  
`rawQueryString()`gibt zurück: `""`

**Fall 3: `undefined` zurückgegeben (keine Abfragezeichenfolge und nein`?`)**  
URL der eingehenden Anfrage: `https://example.com/page`  
`rawQueryString()`gibt zurück: `undefined`