Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Metodi generali di supporto
<a name="general-helper-methods"></a>

Questa pagina fornisce metodi di supporto aggiuntivi all'interno CloudFront di Functions. Per utilizzare questi metodi, create una CloudFront funzione utilizzando JavaScript runtime 2.0.

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

Per ulteriori informazioni, consulta [JavaScript funzionalità di runtime 2.0 per CloudFront Functions](functions-javascript-runtime-20.md).

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

Questo metodo richiede l'utilizzo del `cloudfront` modulo.

**Nota**  
È possibile utilizzare questo metodo solo per le funzioni di richiesta del visualizzatore. Per le funzioni di risposta del visualizzatore, questo metodo è vuoto.

Utilizzate questo JavaScript oggetto per ottenere il codice dell'aeroporto della edge location, la regione [Regional Edge Cache](HowCloudFrontWorks.md#CloudFrontRegionaledgecaches) prevista o l'indirizzo IP del CloudFront server utilizzato per gestire la richiesta. Questi metadati sono disponibili solo nel trigger dell'evento di richiesta del visualizzatore.

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

L'`cf.edgeLocation`oggetto può contenere quanto segue:

**nome**  
Il [codice IATA](https://en.wikipedia.org/wiki/IATA_airport_code) a tre lettere dell'edge location che ha gestito la richiesta.

**IP del server**  
L' IPv6 indirizzo IPv4 o del server che ha gestito la richiesta.

**region**  
La CloudFront Regional Edge Cache (REC) che la richiesta *dovrebbe utilizzare in* caso di perdita della cache. Questo valore non viene aggiornato nel caso in cui il REC previsto non sia disponibile e per la richiesta venga utilizzato un REC di backup. Questo non include la posizione Origin Shield utilizzata, tranne nei casi in cui il REC principale e l'Origin Shield si trovino nella stessa posizione.

**Nota**  
CloudFront Functions non viene richiamato una seconda volta quando CloudFront è configurato per utilizzare il failover di origine. Per ulteriori informazioni, consulta [Ottimizza l'alta disponibilità con il failover di CloudFront origine](high_availability_origin_failover.md).

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

Questo metodo non richiede il `cloudFront` modulo.

Utilizzate il `rawQueryString()` metodo per recuperare la stringa di query non analizzata e inalterata come stringa.

**Richiesta**

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

**Risposta**

Restituisce la stringa di query completa della richiesta in entrata come valore di stringa senza l'iniziale. `?` 
+ Se non è presente una stringa di query, ma `?` è presente, le funzioni restituiscono una stringa vuota. 
+ Se non è presente una stringa di query e `?` non è presente, la funzione restituisce`undefined`.

**Caso 1: restituita la stringa di query completa (senza interlinea`?`)**  
URL della richiesta in entrata: `https://example.com/page?name=John&age=25&city=Boston`  
`rawQueryString()`restituisce: `"name=John&age=25&city=Boston"`

**Caso 2: restituita una stringa vuota (quando `?` è presente ma senza parametri)**  
URL della richiesta in entrata: `https://example.com/page?`  
`rawQueryString()`restituisce: `""`

**Caso 3: `undefined` restituito (nessuna stringa di query e no`?`)**  
URL della richiesta in entrata: `https://example.com/page`  
`rawQueryString()`restituisce: `undefined`