Extraction : incluse dans le périmètre, globale

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 3 minutes de lecture
  • L’API Fetch fournit des méthodes d’extraction de ressources à l’aide d’objets de demande et de réponse.

    Vous pouvez utiliser l’API Fetch dans un script en arrière-plan et partout où vous pouvez effectuer des appels HTTP (comme un point de terminaison REST). L’API Fetch vous permet d’effectuer des demandes d’extraction simples et plus compliquées en définissant des en-têtes, des options de corps, etc.

    Cette API fait partie d’un ensemble d’API d’extraction , qui fournissent diverses actions pour extraire des ressources à partir de sites Web externes. La collection complète d’API d’extraction comprend :

    Pour prendre en charge les actions d’extraction, la propriété système glide.hosts.allowlist permet de contrôler les hôtes auxquels une méthode d’extraction peut accéder. Elle s’applique aux API HTTP telles que RestMessageV2 et celles mentionnées ci-dessus. Pour plus d’informations sur glide.hosts.allowlist, reportez-vous à la section Available system properties.

    Fetch : fetch(ressource de chaîne, options de l’objet)

    Démarre le processus d’extraction d’une ressource du réseau et renvoie une promesse qui est tenue une fois la réponse disponible.

    Tableau 1. Paramètres
    Nom Type Description
    Ressource Chaîne ou objet Requis. La ressource à extraire.
    Valeurs acceptées :
    • Chaîne ou objet avec un stringifier, y compris un objet URL, qui fournit l’URL de la ressource que vous souhaitez extraire. L’URL peut être relative à l’URL de base qui est l’URI de base du document.
    • Un Récupérer la demande : request() objet.
    options Objet Facultatif. Objet Extraire RequestInit : incluse dans le périmètre, globale contenant des paramètres personnalisés à appliquer à la demande.

    Par défaut : la demande est transmise sans aucun paramètre de personnalisation.

    Tableau 2. Renvoie
    Type Description
    Objet Promesse qui se résout en un objet de réponse.
    Une promesse fetch() n’est rejetée que lorsque la demande échoue, par exemple, à cause d’une URL de demande mal formée ou d’une erreur réseau.
    Remarque :
    Une promesse fetch() n’est pas considérée comme rejetée si le serveur répond avec des codes d’état HTTP qui indiquent des erreurs telles que 404 ou 504. Dans ce cas, utilisez un gestionnaire then() pour vérifier les propriétés ok et status Extraire la réponse : incluse dans le périmètre, globale.
    L’exemple suivant montre comment former un nouvel objet Request à l’aide Récupérer la demande : request() de puis fetch() pour récupérer ses données. Voici une explication simple de la façon dont chaque partie du code est utilisée :
    async function fetchIncidents() {
        const url = 'https://your-instance.service-now.com/api/now/table/incident';
        const username = 'your_username';
        const password = 'your_password';
    
        // Create a Request object
        const request = new Request(url, {
            method: 'GET',
            headers: {
                'Content-Type': 'application/json',
                Authorization: 'Basic ' + btoa(`${username}:${password}`)
            }
        });
    
        // Fetch data and use response.json() to process it
        const response = await fetch(request);
        const data = await response.json(); // Parse the response to JSON
        console.log(data.result); // Log the incidents data to system logs
    }
    
    fetchIncidents();

    Sortie :

    [
        { "number": "INC0001", "short_description": "System outage" },
        { "number": "INC0002", "short_description": "Password reset request" }
    ]