@aws-sdk/protocol-http

Creating HTTP Requests

This feature allows you to create an HTTP request object with specified hostname, method, path, and headers. This is useful for setting up requests to AWS services or other endpoints.

const { HttpRequest } = require('@aws-sdk/protocol-http');

const request = new HttpRequest({
  hostname: 'example.com',
  method: 'GET',
  path: '/path',
  headers: {
    'Content-Type': 'application/json'
  }
});

console.log(request);

Handling HTTP Responses

This feature allows you to create an HTTP response object with specified status code, headers, and body. This is useful for handling responses from AWS services or other endpoints.

const { HttpResponse } = require('@aws-sdk/protocol-http');

const response = new HttpResponse({
  statusCode: 200,
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ message: 'Success' })
});

console.log(response);

Middleware Integration

This feature demonstrates how to integrate middleware into the request/response lifecycle. Middleware can be used to add custom logic, such as logging or modifying requests and responses.

const { HttpRequest, HttpResponse } = require('@aws-sdk/protocol-http');
const { middlewareStack } = require('@aws-sdk/middleware-stack');

const stack = middlewareStack();

stack.add(
  (next, context) => async (args) => {
    console.log('Request:', args.request);
    const result = await next(args);
    console.log('Response:', result.response);
    return result;
  },
  {
    step: 'initialize',
    name: 'loggingMiddleware',
    priority: 'high'
  }
);

const request = new HttpRequest({
  hostname: 'example.com',
  method: 'GET',
  path: '/path'
});

stack.resolve(
  (handler) => handler({ request }),
  { request }
).then((result) => console.log(result));