Method request

lib/internal/http2/core.js:1819–1944

(headersParam, options)

  // Submits a new HTTP2 request to the connected peer. Returns the
  // associated Http2Stream instance.
  request(headersParam, options) {
    debugSessionObj(this, 'initiating request');

    // Keep argument validation synchronous, but defer session-state failures
    // to the returned stream so request retries from stream callbacks do not
    // throw before session lifecycle handlers run.
    let requestError;
    if (this.destroyed) {
      requestError = new ERR_HTTP2_INVALID_SESSION();
    } else if (this.closed) {
      requestError = new ERR_HTTP2_GOAWAY_SESSION();
    }

    this[kUpdateTimer]();

    let headersList;
    let headersObject;
    let rawHeaders;
    let scheme;
    let authority;
    let method;

    if (ArrayIsArray(headersParam)) {
      ({
        rawHeaders,
        headersList,
        scheme,
        authority,
        method,
      } = prepareRequestHeadersArray(headersParam, this));
    } else if (!!headersParam && typeof headersParam === 'object') {
      ({
        headersObject,
        headersList,
        scheme,
        authority,
        method,
      } = prepareRequestHeadersObject(headersParam, this));
    } else if (headersParam === undefined) {
      ({
        headersObject,
        headersList,
        scheme,
        authority,
        method,
      } = prepareRequestHeadersObject({}, this));
    } else {
      throw new ERR_INVALID_ARG_TYPE.HideStackFramesError(
        'headers',
        ['Object', 'Array'],
        headersParam,
      );
    }

    assertIsObject(options, 'options');
    options = { ...options };

    setAndValidatePriorityOptions(options);