Dart

HTTP HEAD Request

See more HTTP Examples

Sends an HTTP HEAD request and gets the response.

Note: The response to an HTTP HEAD request is always just the response header. The reponse body is always 0 length (thus the reason it's called a "HEAD" request..)

Dart

import 'package:chilkat/chilkat.dart';

void main() {
  // This example assumes the Chilkat API to have been previously unlocked.
  // See Global Unlock Sample for sample code.

  final http = CkHttp();

  // If the URL uses "https://", then the connection will be TLS.
  // Otherwise it will be TCP.

  // A failure is when we don't get any response.  It could be a timeout, an inability to connect, etc.
  // For example, a "404 Not Found" response is still a response, and thus deemed success in terms of the API..

  final resp = CkHttpResponse();
  try {
    http.httpNoBody('HEAD', 'https://example-code.com/', resp);
  } on ChilkatException catch (e) {
    print(e.lastErrorText);
    return;
  }

  // Examine the response.
  print('Status Code = ${resp.statusCode}');
  print('Status Line = ${resp.statusLine}');
  print('Status Text = ${resp.statusText}');
  print('Full Response Header:');
  print(resp.header);
  print('----');
  final numHeaderFields = resp.numHeaderFields;
  print('Num Header Fields: $numHeaderFields');
  for (var i = 0; i < numHeaderFields; i++) {
    print('${resp.getHeaderName(i)}: ${resp.getHeaderValue(i)}');
  }
}