node/test/parallel/test-http2-session-settings.js

'use strict';

const common = require('../common');
if (!common.hasCrypto)
  common.skip('missing crypto');
const assert = require('assert');
const h2 = require('http2');

const server = h2.createServer();

server.on(
  'stream',
  common.mustCall((stream) => {
    const assertSettings = (settings) => {
      assert.strictEqual(typeof settings, 'object');
      assert.strictEqual(typeof settings.headerTableSize, 'number');
      assert.strictEqual(typeof settings.enablePush, 'boolean');
      assert.strictEqual(typeof settings.initialWindowSize, 'number');
      assert.strictEqual(typeof settings.maxFrameSize, 'number');
      assert.strictEqual(typeof settings.maxConcurrentStreams, 'number');
      assert.strictEqual(typeof settings.maxHeaderListSize, 'number');
    };

    const localSettings = stream.session.localSettings;
    const remoteSettings = stream.session.remoteSettings;
    assertSettings(localSettings);
    assertSettings(remoteSettings);

    // Test that stored settings are returned when called for second time
    assert.strictEqual(stream.session.localSettings, localSettings);
    assert.strictEqual(stream.session.remoteSettings, remoteSettings);

    stream.respond({
      'content-type': 'text/html',
      ':status': 200
    });
    stream.end('hello world');
  })
);

server.listen(
  0,
  common.mustCall(() => {
    const client = h2.connect(`http://localhost:${server.address().port}`, {
      settings: {
        enablePush: false,
        initialWindowSize: 123456
      }
    });

    client.on(
      'localSettings',
      common.mustCall((settings) => {
        assert(settings);
        assert.strictEqual(settings.enablePush, false);
        assert.strictEqual(settings.initialWindowSize, 123456);
        assert.strictEqual(settings.maxFrameSize, 16384);
      }, 2)
    );
    client.on(
      'remoteSettings',
      common.mustCall((settings) => {
        assert(settings);
      })
    );

    const headers = { ':path': '/' };

    const req = client.request(headers);

    req.on(
      'connect',
      common.mustCall(() => {
        // pendingSettingsAck will be true if a SETTINGS frame
        // has been sent but we are still waiting for an acknowledgement
        assert(client.pendingSettingsAck);
      })
    );

    // State will only be valid after connect event is emitted
    req.on(
      'ready',
      common.mustCall(() => {
        assert.doesNotThrow(() => {
          client.settings({
            maxHeaderListSize: 1
          });
        });

        // Verify valid error ranges
        [
          ['headerTableSize', -1],
          ['headerTableSize', 2 ** 32],
          ['initialWindowSize', -1],
          ['initialWindowSize', 2 ** 32],
          ['maxFrameSize', 16383],
          ['maxFrameSize', 2 ** 24],
          ['maxHeaderListSize', -1],
          ['maxHeaderListSize', 2 ** 32]
        ].forEach((i) => {
          const settings = {};
          settings[i[0]] = i[1];
          common.expectsError(
            () => client.settings(settings),
            {
              type: RangeError,
              code: 'ERR_HTTP2_INVALID_SETTING_VALUE',
              message: `Invalid value for setting "${i[0]}": ${i[1]}`
            }
          );
        });

        // error checks for enablePush
        [1, {}, 'test', [], null, Infinity, NaN].forEach((i) => {
          common.expectsError(
            () => client.settings({ enablePush: i }),
            {
              type: TypeError,
              code: 'ERR_HTTP2_INVALID_SETTING_VALUE',
              message: `Invalid value for setting "enablePush": ${i}`
            }
          );
        });
      })
    );

    req.on('response', common.mustCall());
    req.resume();
    req.on(
      'end',
      common.mustCall(() => {
        server.close();
        client.destroy();
      })
    );
    req.end();
  })
);