Requête HTTP Basique

Cet exemple montre comment effectuer des requêtes HTTP de base (GET, POST) avec Unireq.

Démarrage rapide avec httpClient()

Le moyen le plus simple de faire des requêtes HTTP :

import { httpClient } from '@unireq/presets';

// Créer un client avec des valeurs par défaut sensées
const api = httpClient('https://jsonplaceholder.typicode.com');

// Faire des requêtes
const response = await api.get('/posts/1');
console.log(response.data);

// Avec options
const api = httpClient('https://api.example.com', {
  timeout: 10000,
  headers: { 'X-API-Key': 'secret' },
  json: true,           // défaut: true
  followRedirects: true, // défaut: true
});

Méthodes safe avec Result

Utilisez les méthodes safe.* pour une gestion fonctionnelle des erreurs sans try/catch :

import { httpClient } from '@unireq/presets';

const api = httpClient('https://jsonplaceholder.typicode.com');

// Retourne Result<Response, Error> au lieu de lever une exception
const result = await api.safe.get('/posts/1');

if (result.isOk()) {
  console.log('Succès:', result.value.data);
} else {
  console.error('Échec:', result.error.message);
}

// Chaîner les opérations avec map
const title = await api.safe.get<{ title: string }>('/posts/1')
  .then(r => r.map(res => res.data.title));

if (title.isOk()) {
  console.log('Titre:', title.value);
}

Client personnalisé

Pour un contrôle total, créez un client avec composition de policies :

import { client } from '@unireq/core';
import { http, parse } from '@unireq/http';

// Création du client avec transport HTTP et parseur JSON
const api = client(
  http('https://jsonplaceholder.typicode.com'),
  parse.json()
);

// Requête GET typée
interface Post {
  id: number;
  title: string;
}

const response = await api.get<Post>('/posts/1');

console.log(`Status: ${response.status}`);
console.log(`Titre: ${response.data.title}`);

Comparaison avec Axios

Axios

const axios = require('axios');

const api = axios.create({
  baseURL: 'https://jsonplaceholder.typicode.com'
});

try {
  const response = await api.get('/posts/1');
  console.log(response.data);
} catch (error) {
  console.error(error);
}

Différences

1. Gestion d'Erreur : Axios lève une exception pour les erreurs non-2xx. Unireq ne le fait pas par défaut (vous devez vérifier response.ok).
2. Parsing : Axios parse le JSON automatiquement par défaut. Unireq est explicite : vous ajoutez parse.json() si vous voulez du JSON. Cela permet de supporter d'autres formats (XML, ProtoBuf, etc.) sans bloat.
3. Typage : Unireq est conçu pour TypeScript first.

---

← Accueil · Authentification →