electron/spec/api-net-spec.ts

2172 lines
85 KiB
TypeScript
Raw Normal View History

2020-03-20 20:28:31 +00:00
import { expect } from 'chai';
chore: upgrade to Node.js v18 (#35999) * chore: update to Node.js v18 * child_process: improve argument validation https://github.com/nodejs/node/pull/41305 * bootstrap: support configure-time user-land snapshot https://github.com/nodejs/node/pull/42466 * chore: update GN patch * src: disambiguate terms used to refer to builtins and addons https://github.com/nodejs/node/pull/44135 * src: use a typed array internally for process._exiting https://github.com/nodejs/node/pull/43883 * chore: lib/internal/bootstrap -> lib/internal/process * src: disambiguate terms used to refer to builtins and addons https://github.com/nodejs/node/pull/44135 * chore: remove redudant browserGlobals patch * chore: update BoringSSL patch * src: allow embedder-provided PageAllocator in NodePlatform https://github.com/nodejs/node/pull/38362 * chore: fixup Node.js crypto tests - https://github.com/nodejs/node/pull/44171 - https://github.com/nodejs/node/pull/41600 * lib: add Promise methods to avoid-prototype-pollution lint rule https://github.com/nodejs/node/pull/43849 * deps: update V8 to 10.1 https://github.com/nodejs/node/pull/42657 * src: add kNoBrowserGlobals flag for Environment https://github.com/nodejs/node/pull/40532 * chore: consolidate asar initialization patches * deps: update V8 to 10.1 https://github.com/nodejs/node/pull/42657 * deps: update V8 to 9.8 https://github.com/nodejs/node/pull/41610 * src,crypto: remove AllocatedBuffers from crypto_spkac https://github.com/nodejs/node/pull/40752 * build: enable V8's shared read-only heap https://github.com/nodejs/node/pull/42809 * src: fix ssize_t error from nghttp2.h https://github.com/nodejs/node/pull/44393 * chore: fixup ESM patch * chore: fixup patch indices * src: merge NativeModuleEnv into NativeModuleLoader https://github.com/nodejs/node/pull/43824 * [API] Pass OOMDetails to OOMErrorCallback https://chromium-review.googlesource.com/c/v8/v8/+/3647827 * src: iwyu in cleanup_queue.cc * src: return Maybe from a couple of functions https://github.com/nodejs/node/pull/39603 * src: clean up embedder API https://github.com/nodejs/node/pull/35897 * src: refactor DH groups to delete crypto_groups.h https://github.com/nodejs/node/pull/43896 * deps,src: use SIMD for normal base64 encoding https://github.com/nodejs/node/pull/39775 * chore: remove deleted source file * chore: update patches * chore: remove deleted source file * lib: add fetch https://github.com/nodejs/node/pull/41749 * chore: remove nonexistent node specs * test: split report OOM tests https://github.com/nodejs/node/pull/44389 * src: trace fs async api https://github.com/nodejs/node/pull/44057 * http: trace http request / response https://github.com/nodejs/node/pull/44102 * test: split test-crypto-dh.js https://github.com/nodejs/node/pull/40451 * crypto: introduce X509Certificate API https://github.com/nodejs/node/pull/36804 * src: split property helpers from node::Environment https://github.com/nodejs/node/pull/44056 * https://github.com/nodejs/node/pull/38905 bootstrap: implement run-time user-land snapshots via --build-snapshot and --snapshot-blob * lib,src: implement WebAssembly Web API https://github.com/nodejs/node/pull/42701 * fixup! deps,src: use SIMD for normal base64 encoding * fixup! src: refactor DH groups to delete crypto_groups.h * chore: fixup base64 GN file * fix: check that node::InitializeContext() returns true * chore: delete _noBrowserGlobals usage * chore: disable fetch in renderer procceses * dns: default to verbatim=true in dns.lookup() https://github.com/nodejs/node/pull/39987 Co-authored-by: PatchUp <73610968+patchup[bot]@users.noreply.github.com>
2022-11-10 21:31:20 +00:00
import * as dns from 'dns';
import { net, session, ClientRequest, BrowserWindow, ClientRequestConstructorOptions } from 'electron/main';
2020-03-20 20:28:31 +00:00
import * as http from 'http';
import * as url from 'url';
import { Socket } from 'net';
import { defer, listen } from './lib/spec-helpers';
import { once } from 'events';
import { setTimeout } from 'timers/promises';
chore: upgrade to Node.js v18 (#35999) * chore: update to Node.js v18 * child_process: improve argument validation https://github.com/nodejs/node/pull/41305 * bootstrap: support configure-time user-land snapshot https://github.com/nodejs/node/pull/42466 * chore: update GN patch * src: disambiguate terms used to refer to builtins and addons https://github.com/nodejs/node/pull/44135 * src: use a typed array internally for process._exiting https://github.com/nodejs/node/pull/43883 * chore: lib/internal/bootstrap -> lib/internal/process * src: disambiguate terms used to refer to builtins and addons https://github.com/nodejs/node/pull/44135 * chore: remove redudant browserGlobals patch * chore: update BoringSSL patch * src: allow embedder-provided PageAllocator in NodePlatform https://github.com/nodejs/node/pull/38362 * chore: fixup Node.js crypto tests - https://github.com/nodejs/node/pull/44171 - https://github.com/nodejs/node/pull/41600 * lib: add Promise methods to avoid-prototype-pollution lint rule https://github.com/nodejs/node/pull/43849 * deps: update V8 to 10.1 https://github.com/nodejs/node/pull/42657 * src: add kNoBrowserGlobals flag for Environment https://github.com/nodejs/node/pull/40532 * chore: consolidate asar initialization patches * deps: update V8 to 10.1 https://github.com/nodejs/node/pull/42657 * deps: update V8 to 9.8 https://github.com/nodejs/node/pull/41610 * src,crypto: remove AllocatedBuffers from crypto_spkac https://github.com/nodejs/node/pull/40752 * build: enable V8's shared read-only heap https://github.com/nodejs/node/pull/42809 * src: fix ssize_t error from nghttp2.h https://github.com/nodejs/node/pull/44393 * chore: fixup ESM patch * chore: fixup patch indices * src: merge NativeModuleEnv into NativeModuleLoader https://github.com/nodejs/node/pull/43824 * [API] Pass OOMDetails to OOMErrorCallback https://chromium-review.googlesource.com/c/v8/v8/+/3647827 * src: iwyu in cleanup_queue.cc * src: return Maybe from a couple of functions https://github.com/nodejs/node/pull/39603 * src: clean up embedder API https://github.com/nodejs/node/pull/35897 * src: refactor DH groups to delete crypto_groups.h https://github.com/nodejs/node/pull/43896 * deps,src: use SIMD for normal base64 encoding https://github.com/nodejs/node/pull/39775 * chore: remove deleted source file * chore: update patches * chore: remove deleted source file * lib: add fetch https://github.com/nodejs/node/pull/41749 * chore: remove nonexistent node specs * test: split report OOM tests https://github.com/nodejs/node/pull/44389 * src: trace fs async api https://github.com/nodejs/node/pull/44057 * http: trace http request / response https://github.com/nodejs/node/pull/44102 * test: split test-crypto-dh.js https://github.com/nodejs/node/pull/40451 * crypto: introduce X509Certificate API https://github.com/nodejs/node/pull/36804 * src: split property helpers from node::Environment https://github.com/nodejs/node/pull/44056 * https://github.com/nodejs/node/pull/38905 bootstrap: implement run-time user-land snapshots via --build-snapshot and --snapshot-blob * lib,src: implement WebAssembly Web API https://github.com/nodejs/node/pull/42701 * fixup! deps,src: use SIMD for normal base64 encoding * fixup! src: refactor DH groups to delete crypto_groups.h * chore: fixup base64 GN file * fix: check that node::InitializeContext() returns true * chore: delete _noBrowserGlobals usage * chore: disable fetch in renderer procceses * dns: default to verbatim=true in dns.lookup() https://github.com/nodejs/node/pull/39987 Co-authored-by: PatchUp <73610968+patchup[bot]@users.noreply.github.com>
2022-11-10 21:31:20 +00:00
// See https://github.com/nodejs/node/issues/40702.
dns.setDefaultResultOrder('ipv4first');
2020-03-20 20:28:31 +00:00
const kOneKiloByte = 1024;
const kOneMegaByte = kOneKiloByte * kOneKiloByte;
2019-06-14 23:26:07 +00:00
function randomBuffer (size: number, start: number = 0, end: number = 255) {
2020-03-20 20:28:31 +00:00
const range = 1 + end - start;
const buffer = Buffer.allocUnsafe(size);
2019-06-14 23:26:07 +00:00
for (let i = 0; i < size; ++i) {
2020-03-20 20:28:31 +00:00
buffer[i] = start + Math.floor(Math.random() * range);
2019-06-14 23:26:07 +00:00
}
2020-03-20 20:28:31 +00:00
return buffer;
2019-06-14 23:26:07 +00:00
}
function randomString (length: number) {
2020-03-20 20:28:31 +00:00
const buffer = randomBuffer(length, '0'.charCodeAt(0), 'z'.charCodeAt(0));
return buffer.toString();
2019-06-14 23:26:07 +00:00
}
async function getResponse (urlRequest: Electron.ClientRequest) {
return new Promise<Electron.IncomingMessage>((resolve, reject) => {
2020-03-20 20:28:31 +00:00
urlRequest.on('error', reject);
urlRequest.on('abort', reject);
urlRequest.on('response', (response) => resolve(response));
urlRequest.end();
});
}
async function collectStreamBody (response: Electron.IncomingMessage | http.IncomingMessage) {
2020-03-20 20:28:31 +00:00
return (await collectStreamBodyBuffer(response)).toString();
}
function collectStreamBodyBuffer (response: Electron.IncomingMessage | http.IncomingMessage) {
return new Promise<Buffer>((resolve, reject) => {
response.on('error', reject);
2020-03-20 20:28:31 +00:00
(response as NodeJS.EventEmitter).on('aborted', reject);
const data: Buffer[] = [];
response.on('data', (chunk) => data.push(chunk));
response.on('end', (chunk?: Buffer) => {
2020-03-20 20:28:31 +00:00
if (chunk) data.push(chunk);
resolve(Buffer.concat(data));
});
});
}
async function respondNTimes (fn: http.RequestListener, n: number): Promise<string> {
const server = http.createServer((request, response) => {
fn(request, response);
// don't close if a redirect was returned
if ((response.statusCode < 300 || response.statusCode >= 399) && n <= 0) {
n--;
2020-03-20 20:28:31 +00:00
server.close();
}
});
const sockets: Socket[] = [];
server.on('connection', s => sockets.push(s));
defer(() => {
server.close();
sockets.forEach(s => s.destroy());
2020-03-20 20:28:31 +00:00
});
return (await listen(server)).url;
2019-06-14 23:26:07 +00:00
}
function respondOnce (fn: http.RequestListener) {
2020-03-20 20:28:31 +00:00
return respondNTimes(fn, 1);
}
2020-03-20 20:28:31 +00:00
let routeFailure = false;
respondNTimes.toRoutes = (routes: Record<string, http.RequestListener>, n: number) => {
return respondNTimes((request, response) => {
if (Object.prototype.hasOwnProperty.call(routes, request.url || '')) {
(async () => {
2020-03-20 20:28:31 +00:00
await Promise.resolve(routes[request.url || ''](request, response));
})().catch((err) => {
2020-03-20 20:28:31 +00:00
routeFailure = true;
console.error('Route handler failed, this is probably why your test failed', err);
response.statusCode = 500;
response.end();
});
2019-06-14 23:26:07 +00:00
} else {
2020-03-20 20:28:31 +00:00
response.statusCode = 500;
response.end();
expect.fail(`Unexpected URL: ${request.url}`);
2019-06-14 23:26:07 +00:00
}
2020-03-20 20:28:31 +00:00
}, n);
};
respondOnce.toRoutes = (routes: Record<string, http.RequestListener>) => respondNTimes.toRoutes(routes, 1);
2019-06-14 23:26:07 +00:00
respondNTimes.toURL = (url: string, fn: http.RequestListener, n: number) => {
2020-03-20 20:28:31 +00:00
return respondNTimes.toRoutes({ [url]: fn }, n);
};
respondOnce.toURL = (url: string, fn: http.RequestListener) => respondNTimes.toURL(url, fn, 1);
2019-06-14 23:26:07 +00:00
respondNTimes.toSingleURL = (fn: http.RequestListener, n: number) => {
2020-03-20 20:28:31 +00:00
const requestUrl = '/requestUrl';
return respondNTimes.toURL(requestUrl, fn, n).then(url => `${url}${requestUrl}`);
};
respondOnce.toSingleURL = (fn: http.RequestListener) => respondNTimes.toSingleURL(fn, 1);
2019-06-14 23:26:07 +00:00
describe('net module', () => {
beforeEach(() => {
2020-03-20 20:28:31 +00:00
routeFailure = false;
});
afterEach(async function () {
2020-03-20 20:28:31 +00:00
await session.defaultSession.clearCache();
if (routeFailure && this.test) {
if (!this.test.isFailed()) {
2020-03-20 20:28:31 +00:00
throw new Error('Failing this test due an unhandled error in the respondOnce route handler, check the logs above for the actual error');
}
}
2020-03-20 20:28:31 +00:00
});
2019-06-14 23:26:07 +00:00
describe('HTTP basics', () => {
it('should be able to issue a basic GET request', async () => {
const serverUrl = await respondOnce.toSingleURL((request, response) => {
2020-03-20 20:28:31 +00:00
expect(request.method).to.equal('GET');
response.end();
});
const urlRequest = net.request(serverUrl);
const response = await getResponse(urlRequest);
expect(response.statusCode).to.equal(200);
await collectStreamBody(response);
});
2019-06-14 23:26:07 +00:00
it('should be able to issue a basic POST request', async () => {
const serverUrl = await respondOnce.toSingleURL((request, response) => {
2020-03-20 20:28:31 +00:00
expect(request.method).to.equal('POST');
response.end();
});
const urlRequest = net.request({
method: 'POST',
url: serverUrl
2020-03-20 20:28:31 +00:00
});
const response = await getResponse(urlRequest);
expect(response.statusCode).to.equal(200);
await collectStreamBody(response);
});
2019-06-14 23:26:07 +00:00
it('should fetch correct data in a GET request', async () => {
2020-03-20 20:28:31 +00:00
const expectedBodyData = 'Hello World!';
const serverUrl = await respondOnce.toSingleURL((request, response) => {
2020-03-20 20:28:31 +00:00
expect(request.method).to.equal('GET');
response.end(expectedBodyData);
});
const urlRequest = net.request(serverUrl);
const response = await getResponse(urlRequest);
expect(response.statusCode).to.equal(200);
const body = await collectStreamBody(response);
expect(body).to.equal(expectedBodyData);
});
2019-06-14 23:26:07 +00:00
it('should post the correct data in a POST request', async () => {
2020-03-20 20:28:31 +00:00
const bodyData = 'Hello World!';
const serverUrl = await respondOnce.toSingleURL(async (request, response) => {
2020-03-20 20:28:31 +00:00
const postedBodyData = await collectStreamBody(request);
expect(postedBodyData).to.equal(bodyData);
response.end();
});
const urlRequest = net.request({
method: 'POST',
url: serverUrl
2020-03-20 20:28:31 +00:00
});
urlRequest.write(bodyData);
const response = await getResponse(urlRequest);
expect(response.statusCode).to.equal(200);
});
2019-06-14 23:26:07 +00:00
it('should support chunked encoding', async () => {
const serverUrl = await respondOnce.toSingleURL((request, response) => {
2020-03-20 20:28:31 +00:00
response.statusCode = 200;
response.statusMessage = 'OK';
response.chunkedEncoding = true;
expect(request.method).to.equal('POST');
expect(request.headers['transfer-encoding']).to.equal('chunked');
expect(request.headers['content-length']).to.equal(undefined);
2019-06-14 23:26:07 +00:00
request.on('data', (chunk: Buffer) => {
2020-03-20 20:28:31 +00:00
response.write(chunk);
});
2019-06-14 23:26:07 +00:00
request.on('end', (chunk: Buffer) => {
2020-03-20 20:28:31 +00:00
response.end(chunk);
});
});
const urlRequest = net.request({
method: 'POST',
url: serverUrl
2020-03-20 20:28:31 +00:00
});
2020-03-20 20:28:31 +00:00
let chunkIndex = 0;
const chunkCount = 100;
let sent = Buffer.alloc(0);
2020-03-20 20:28:31 +00:00
urlRequest.chunkedEncoding = true;
while (chunkIndex < chunkCount) {
2020-03-20 20:28:31 +00:00
chunkIndex += 1;
const chunk = randomBuffer(kOneKiloByte);
sent = Buffer.concat([sent, chunk]);
urlRequest.write(chunk);
}
2020-03-20 20:28:31 +00:00
const response = await getResponse(urlRequest);
expect(response.statusCode).to.equal(200);
const received = await collectStreamBodyBuffer(response);
expect(sent.equals(received)).to.be.true();
expect(chunkIndex).to.be.equal(chunkCount);
});
for (const extraOptions of [{}, { credentials: 'include' }, { useSessionCookies: false, credentials: 'include' }] as ClientRequestConstructorOptions[]) {
describe(`authentication when ${JSON.stringify(extraOptions)}`, () => {
it('should emit the login event when 401', async () => {
const [user, pass] = ['user', 'pass'];
const serverUrl = await respondOnce.toSingleURL((request, response) => {
if (!request.headers.authorization) {
return response.writeHead(401, { 'WWW-Authenticate': 'Basic realm="Foo"' }).end();
}
response.writeHead(200).end('ok');
});
let loginAuthInfo: Electron.AuthInfo;
const request = net.request({ method: 'GET', url: serverUrl, ...extraOptions });
request.on('login', (authInfo, cb) => {
loginAuthInfo = authInfo;
cb(user, pass);
});
const response = await getResponse(request);
expect(response.statusCode).to.equal(200);
expect(loginAuthInfo!.realm).to.equal('Foo');
expect(loginAuthInfo!.scheme).to.equal('basic');
});
it('should receive 401 response when cancelling authentication', async () => {
const serverUrl = await respondOnce.toSingleURL((request, response) => {
if (!request.headers.authorization) {
response.writeHead(401, { 'WWW-Authenticate': 'Basic realm="Foo"' });
response.end('unauthenticated');
} else {
response.writeHead(200).end('ok');
}
});
const request = net.request({ method: 'GET', url: serverUrl, ...extraOptions });
request.on('login', (authInfo, cb) => {
cb();
});
const response = await getResponse(request);
const body = await collectStreamBody(response);
expect(response.statusCode).to.equal(401);
expect(body).to.equal('unauthenticated');
});
it('should share credentials with WebContents', async () => {
const [user, pass] = ['user', 'pass'];
const serverUrl = await respondNTimes.toSingleURL((request, response) => {
if (!request.headers.authorization) {
return response.writeHead(401, { 'WWW-Authenticate': 'Basic realm="Foo"' }).end();
}
return response.writeHead(200).end('ok');
}, 2);
const bw = new BrowserWindow({ show: false });
bw.webContents.on('login', (event, details, authInfo, cb) => {
event.preventDefault();
cb(user, pass);
});
await bw.loadURL(serverUrl);
bw.close();
const request = net.request({ method: 'GET', url: serverUrl, ...extraOptions });
let logInCount = 0;
request.on('login', () => {
logInCount++;
});
const response = await getResponse(request);
await collectStreamBody(response);
expect(logInCount).to.equal(0, 'should not receive a login event, credentials should be cached');
});
it('should share proxy credentials with WebContents', async () => {
const [user, pass] = ['user', 'pass'];
const proxyUrl = await respondNTimes((request, response) => {
if (!request.headers['proxy-authorization']) {
return response.writeHead(407, { 'Proxy-Authenticate': 'Basic realm="Foo"' }).end();
}
return response.writeHead(200).end('ok');
}, 2);
const customSession = session.fromPartition(`net-proxy-test-${Math.random()}`);
await customSession.setProxy({ proxyRules: proxyUrl.replace('http://', ''), proxyBypassRules: '<-loopback>' });
const bw = new BrowserWindow({ show: false, webPreferences: { session: customSession } });
bw.webContents.on('login', (event, details, authInfo, cb) => {
event.preventDefault();
cb(user, pass);
});
await bw.loadURL('http://127.0.0.1:9999');
bw.close();
const request = net.request({ method: 'GET', url: 'http://127.0.0.1:9999', session: customSession, ...extraOptions });
let logInCount = 0;
request.on('login', () => {
logInCount++;
});
const response = await getResponse(request);
const body = await collectStreamBody(response);
expect(response.statusCode).to.equal(200);
expect(body).to.equal('ok');
expect(logInCount).to.equal(0, 'should not receive a login event, credentials should be cached');
});
it('should upload body when 401', async () => {
const [user, pass] = ['user', 'pass'];
const serverUrl = await respondOnce.toSingleURL((request, response) => {
if (!request.headers.authorization) {
return response.writeHead(401, { 'WWW-Authenticate': 'Basic realm="Foo"' }).end();
}
response.writeHead(200);
request.on('data', (chunk) => response.write(chunk));
request.on('end', () => response.end());
});
const requestData = randomString(kOneKiloByte);
const request = net.request({ method: 'GET', url: serverUrl, ...extraOptions });
request.on('login', (authInfo, cb) => {
cb(user, pass);
});
request.write(requestData);
const response = await getResponse(request);
const responseData = await collectStreamBody(response);
expect(responseData).to.equal(requestData);
});
2020-03-20 20:28:31 +00:00
});
}
describe('authentication when {"credentials":"omit"}', () => {
it('should not emit the login event when 401', async () => {
const serverUrl = await respondOnce.toSingleURL((request, response) => {
if (!request.headers.authorization) {
return response.writeHead(401, { 'WWW-Authenticate': 'Basic realm="Foo"' }).end();
}
response.writeHead(200).end('ok');
});
const request = net.request({ method: 'GET', url: serverUrl, credentials: 'omit' });
request.on('login', () => {
expect.fail('unexpected login event');
});
const response = await getResponse(request);
expect(response.statusCode).to.equal(401);
expect(response.headers['www-authenticate']).to.equal('Basic realm="Foo"');
});
it('should not share credentials with WebContents', async () => {
const [user, pass] = ['user', 'pass'];
const serverUrl = await respondNTimes.toSingleURL((request, response) => {
if (!request.headers.authorization) {
return response.writeHead(401, { 'WWW-Authenticate': 'Basic realm="Foo"' }).end();
}
return response.writeHead(200).end('ok');
}, 2);
const bw = new BrowserWindow({ show: false });
bw.webContents.on('login', (event, details, authInfo, cb) => {
event.preventDefault();
cb(user, pass);
});
await bw.loadURL(serverUrl);
bw.close();
const request = net.request({ method: 'GET', url: serverUrl, credentials: 'omit' });
request.on('login', () => {
expect.fail();
});
const response = await getResponse(request);
expect(response.statusCode).to.equal(401);
expect(response.headers['www-authenticate']).to.equal('Basic realm="Foo"');
});
it('should share proxy credentials with WebContents', async () => {
const [user, pass] = ['user', 'pass'];
const proxyUrl = await respondNTimes((request, response) => {
if (!request.headers['proxy-authorization']) {
return response.writeHead(407, { 'Proxy-Authenticate': 'Basic realm="Foo"' }).end();
}
return response.writeHead(200).end('ok');
}, 2);
const customSession = session.fromPartition(`net-proxy-test-${Math.random()}`);
await customSession.setProxy({ proxyRules: proxyUrl.replace('http://', ''), proxyBypassRules: '<-loopback>' });
const bw = new BrowserWindow({ show: false, webPreferences: { session: customSession } });
bw.webContents.on('login', (event, details, authInfo, cb) => {
event.preventDefault();
cb(user, pass);
});
await bw.loadURL('http://127.0.0.1:9999');
bw.close();
const request = net.request({ method: 'GET', url: 'http://127.0.0.1:9999', session: customSession, credentials: 'omit' });
request.on('login', () => {
expect.fail();
});
const response = await getResponse(request);
const body = await collectStreamBody(response);
expect(response.statusCode).to.equal(200);
expect(body).to.equal('ok');
});
2020-03-20 20:28:31 +00:00
});
});
2019-06-14 23:26:07 +00:00
describe('ClientRequest API', () => {
it('request/response objects should emit expected events', async () => {
2020-03-20 20:28:31 +00:00
const bodyData = randomString(kOneKiloByte);
const serverUrl = await respondOnce.toSingleURL((request, response) => {
2020-03-20 20:28:31 +00:00
response.end(bodyData);
});
2020-03-20 20:28:31 +00:00
const urlRequest = net.request(serverUrl);
// request close event
const closePromise = once(urlRequest, 'close');
// request finish event
const finishPromise = once(urlRequest, 'close');
// request "response" event
2020-03-20 20:28:31 +00:00
const response = await getResponse(urlRequest);
response.on('error', (error: Error) => {
2020-03-20 20:28:31 +00:00
expect(error).to.be.an('Error');
});
const statusCode = response.statusCode;
expect(statusCode).to.equal(200);
// response data event
// respond end event
2020-03-20 20:28:31 +00:00
const body = await collectStreamBody(response);
expect(body).to.equal(bodyData);
urlRequest.on('error', (error) => {
2020-03-20 20:28:31 +00:00
expect(error).to.be.an('Error');
});
await Promise.all([closePromise, finishPromise]);
});
2019-06-14 23:26:07 +00:00
it('should be able to set a custom HTTP request header before first write', async () => {
2020-03-20 20:28:31 +00:00
const customHeaderName = 'Some-Custom-Header-Name';
const customHeaderValue = 'Some-Customer-Header-Value';
const serverUrl = await respondOnce.toSingleURL((request, response) => {
2020-03-20 20:28:31 +00:00
expect(request.headers[customHeaderName.toLowerCase()]).to.equal(customHeaderValue);
response.statusCode = 200;
response.statusMessage = 'OK';
response.end();
});
const urlRequest = net.request(serverUrl);
urlRequest.setHeader(customHeaderName, customHeaderValue);
expect(urlRequest.getHeader(customHeaderName)).to.equal(customHeaderValue);
expect(urlRequest.getHeader(customHeaderName.toLowerCase())).to.equal(customHeaderValue);
urlRequest.write('');
expect(urlRequest.getHeader(customHeaderName)).to.equal(customHeaderValue);
expect(urlRequest.getHeader(customHeaderName.toLowerCase())).to.equal(customHeaderValue);
const response = await getResponse(urlRequest);
expect(response.statusCode).to.equal(200);
await collectStreamBody(response);
});
2019-06-14 23:26:07 +00:00
2019-11-25 20:56:18 +00:00
it('should be able to set a non-string object as a header value', async () => {
2020-03-20 20:28:31 +00:00
const customHeaderName = 'Some-Integer-Value';
const customHeaderValue = 900;
2019-11-25 20:56:18 +00:00
const serverUrl = await respondOnce.toSingleURL((request, response) => {
2020-03-20 20:28:31 +00:00
expect(request.headers[customHeaderName.toLowerCase()]).to.equal(customHeaderValue.toString());
response.statusCode = 200;
response.statusMessage = 'OK';
response.end();
});
const urlRequest = net.request(serverUrl);
urlRequest.setHeader(customHeaderName, customHeaderValue as any);
expect(urlRequest.getHeader(customHeaderName)).to.equal(customHeaderValue);
expect(urlRequest.getHeader(customHeaderName.toLowerCase())).to.equal(customHeaderValue);
urlRequest.write('');
expect(urlRequest.getHeader(customHeaderName)).to.equal(customHeaderValue);
expect(urlRequest.getHeader(customHeaderName.toLowerCase())).to.equal(customHeaderValue);
const response = await getResponse(urlRequest);
expect(response.statusCode).to.equal(200);
await collectStreamBody(response);
});
2019-06-14 23:26:07 +00:00
it('should not change the case of header name', async () => {
const customHeaderName = 'X-Header-Name';
const customHeaderValue = 'value';
const serverUrl = await respondOnce.toSingleURL((request, response) => {
expect(request.headers[customHeaderName.toLowerCase()]).to.equal(customHeaderValue.toString());
expect(request.rawHeaders.includes(customHeaderName)).to.equal(true);
response.statusCode = 200;
response.statusMessage = 'OK';
response.end();
});
const urlRequest = net.request(serverUrl);
urlRequest.setHeader(customHeaderName, customHeaderValue);
expect(urlRequest.getHeader(customHeaderName)).to.equal(customHeaderValue);
urlRequest.write('');
const response = await getResponse(urlRequest);
expect(response.statusCode).to.equal(200);
await collectStreamBody(response);
});
it('should not be able to set a custom HTTP request header after first write', async () => {
2020-03-20 20:28:31 +00:00
const customHeaderName = 'Some-Custom-Header-Name';
const customHeaderValue = 'Some-Customer-Header-Value';
const serverUrl = await respondOnce.toSingleURL((request, response) => {
2020-03-20 20:28:31 +00:00
expect(request.headers[customHeaderName.toLowerCase()]).to.equal(undefined);
response.statusCode = 200;
response.statusMessage = 'OK';
response.end();
});
const urlRequest = net.request(serverUrl);
urlRequest.write('');
expect(() => {
2020-03-20 20:28:31 +00:00
urlRequest.setHeader(customHeaderName, customHeaderValue);
}).to.throw();
expect(urlRequest.getHeader(customHeaderName)).to.equal(undefined);
const response = await getResponse(urlRequest);
expect(response.statusCode).to.equal(200);
await collectStreamBody(response);
});
2019-06-14 23:26:07 +00:00
it('should be able to remove a custom HTTP request header before first write', async () => {
2020-03-20 20:28:31 +00:00
const customHeaderName = 'Some-Custom-Header-Name';
const customHeaderValue = 'Some-Customer-Header-Value';
const serverUrl = await respondOnce.toSingleURL((request, response) => {
2020-03-20 20:28:31 +00:00
expect(request.headers[customHeaderName.toLowerCase()]).to.equal(undefined);
response.statusCode = 200;
response.statusMessage = 'OK';
response.end();
});
const urlRequest = net.request(serverUrl);
urlRequest.setHeader(customHeaderName, customHeaderValue);
expect(urlRequest.getHeader(customHeaderName)).to.equal(customHeaderValue);
urlRequest.removeHeader(customHeaderName);
expect(urlRequest.getHeader(customHeaderName)).to.equal(undefined);
urlRequest.write('');
const response = await getResponse(urlRequest);
expect(response.statusCode).to.equal(200);
await collectStreamBody(response);
});
2019-06-14 23:26:07 +00:00
it('should not be able to remove a custom HTTP request header after first write', async () => {
2020-03-20 20:28:31 +00:00
const customHeaderName = 'Some-Custom-Header-Name';
const customHeaderValue = 'Some-Customer-Header-Value';
const serverUrl = await respondOnce.toSingleURL((request, response) => {
2020-03-20 20:28:31 +00:00
expect(request.headers[customHeaderName.toLowerCase()]).to.equal(customHeaderValue);
response.statusCode = 200;
response.statusMessage = 'OK';
response.end();
});
const urlRequest = net.request(serverUrl);
urlRequest.setHeader(customHeaderName, customHeaderValue);
expect(urlRequest.getHeader(customHeaderName)).to.equal(customHeaderValue);
urlRequest.write('');
expect(() => {
2020-03-20 20:28:31 +00:00
urlRequest.removeHeader(customHeaderName);
}).to.throw();
expect(urlRequest.getHeader(customHeaderName)).to.equal(customHeaderValue);
const response = await getResponse(urlRequest);
expect(response.statusCode).to.equal(200);
await collectStreamBody(response);
});
2019-06-14 23:26:07 +00:00
it('should keep the order of headers', async () => {
const customHeaderNameA = 'X-Header-100';
const customHeaderNameB = 'X-Header-200';
const serverUrl = await respondOnce.toSingleURL((request, response) => {
const headerNames = Array.from(Object.keys(request.headers));
const headerAIndex = headerNames.indexOf(customHeaderNameA.toLowerCase());
const headerBIndex = headerNames.indexOf(customHeaderNameB.toLowerCase());
expect(headerBIndex).to.be.below(headerAIndex);
response.statusCode = 200;
response.statusMessage = 'OK';
response.end();
});
const urlRequest = net.request(serverUrl);
urlRequest.setHeader(customHeaderNameB, 'b');
urlRequest.setHeader(customHeaderNameA, 'a');
const response = await getResponse(urlRequest);
expect(response.statusCode).to.equal(200);
await collectStreamBody(response);
});
it('should be able to set cookie header line', async () => {
2020-03-20 20:28:31 +00:00
const cookieHeaderName = 'Cookie';
const cookieHeaderValue = 'test=12345';
const customSession = session.fromPartition(`test-cookie-header-${Math.random()}`);
const serverUrl = await respondOnce.toSingleURL((request, response) => {
2020-03-20 20:28:31 +00:00
expect(request.headers[cookieHeaderName.toLowerCase()]).to.equal(cookieHeaderValue);
response.statusCode = 200;
response.statusMessage = 'OK';
response.end();
});
await customSession.cookies.set({
url: `${serverUrl}`,
name: 'test',
value: '11111',
expirationDate: 0
2020-03-20 20:28:31 +00:00
});
const urlRequest = net.request({
method: 'GET',
url: serverUrl,
session: customSession
2020-03-20 20:28:31 +00:00
});
urlRequest.setHeader(cookieHeaderName, cookieHeaderValue);
expect(urlRequest.getHeader(cookieHeaderName)).to.equal(cookieHeaderValue);
const response = await getResponse(urlRequest);
expect(response.statusCode).to.equal(200);
await collectStreamBody(response);
});
2019-06-14 23:26:07 +00:00
it('should be able to receive cookies', async () => {
2020-03-20 20:28:31 +00:00
const cookie = ['cookie1', 'cookie2'];
const serverUrl = await respondOnce.toSingleURL((request, response) => {
2020-03-20 20:28:31 +00:00
response.statusCode = 200;
response.statusMessage = 'OK';
response.setHeader('set-cookie', cookie);
response.end();
});
const urlRequest = net.request(serverUrl);
const response = await getResponse(urlRequest);
expect(response.headers['set-cookie']).to.have.same.members(cookie);
});
it('should be able to receive content-type', async () => {
const contentType = 'mime/test; charset=test';
const serverUrl = await respondOnce.toSingleURL((request, response) => {
response.statusCode = 200;
response.statusMessage = 'OK';
response.setHeader('content-type', contentType);
response.end();
});
const urlRequest = net.request(serverUrl);
const response = await getResponse(urlRequest);
expect(response.headers['content-type']).to.equal(contentType);
});
it('should not use the sessions cookie store by default', async () => {
const serverUrl = await respondOnce.toSingleURL((request, response) => {
response.statusCode = 200;
response.statusMessage = 'OK';
response.setHeader('x-cookie', `${request.headers.cookie!}`);
response.end();
});
const sess = session.fromPartition(`cookie-tests-${Math.random()}`);
const cookieVal = `${Date.now()}`;
await sess.cookies.set({
url: serverUrl,
name: 'wild_cookie',
value: cookieVal
});
const urlRequest = net.request({
url: serverUrl,
session: sess
});
const response = await getResponse(urlRequest);
2020-07-09 17:18:49 +00:00
expect(response.headers['x-cookie']).to.equal('undefined');
});
for (const extraOptions of [{ useSessionCookies: true }, { credentials: 'include' }] as ClientRequestConstructorOptions[]) {
describe(`when ${JSON.stringify(extraOptions)}`, () => {
it('should be able to use the sessions cookie store', async () => {
const serverUrl = await respondOnce.toSingleURL((request, response) => {
response.statusCode = 200;
response.statusMessage = 'OK';
response.setHeader('x-cookie', request.headers.cookie!);
response.end();
});
const sess = session.fromPartition(`cookie-tests-${Math.random()}`);
const cookieVal = `${Date.now()}`;
await sess.cookies.set({
url: serverUrl,
name: 'wild_cookie',
value: cookieVal
});
const urlRequest = net.request({
url: serverUrl,
session: sess,
...extraOptions
});
const response = await getResponse(urlRequest);
expect(response.headers['x-cookie']).to.equal(`wild_cookie=${cookieVal}`);
});
it('should be able to use the sessions cookie store with set-cookie', async () => {
const serverUrl = await respondOnce.toSingleURL((request, response) => {
response.statusCode = 200;
response.statusMessage = 'OK';
response.setHeader('set-cookie', 'foo=bar');
response.end();
});
const sess = session.fromPartition(`cookie-tests-${Math.random()}`);
let cookies = await sess.cookies.get({});
expect(cookies).to.have.lengthOf(0);
const urlRequest = net.request({
url: serverUrl,
session: sess,
...extraOptions
});
await collectStreamBody(await getResponse(urlRequest));
cookies = await sess.cookies.get({});
expect(cookies).to.have.lengthOf(1);
expect(cookies[0]).to.deep.equal({
name: 'foo',
value: 'bar',
domain: '127.0.0.1',
hostOnly: true,
path: '/',
secure: false,
httpOnly: false,
session: true,
sameSite: 'unspecified'
});
});
['Lax', 'Strict'].forEach((mode) => {
it(`should be able to use the sessions cookie store with same-site ${mode} cookies`, async () => {
const serverUrl = await respondNTimes.toSingleURL((request, response) => {
response.statusCode = 200;
response.statusMessage = 'OK';
response.setHeader('set-cookie', `same=site; SameSite=${mode}`);
response.setHeader('x-cookie', `${request.headers.cookie}`);
response.end();
}, 2);
const sess = session.fromPartition(`cookie-tests-${Math.random()}`);
let cookies = await sess.cookies.get({});
expect(cookies).to.have.lengthOf(0);
const urlRequest = net.request({
url: serverUrl,
session: sess,
...extraOptions
});
const response = await getResponse(urlRequest);
expect(response.headers['x-cookie']).to.equal('undefined');
await collectStreamBody(response);
cookies = await sess.cookies.get({});
expect(cookies).to.have.lengthOf(1);
expect(cookies[0]).to.deep.equal({
name: 'same',
value: 'site',
domain: '127.0.0.1',
hostOnly: true,
path: '/',
secure: false,
httpOnly: false,
session: true,
sameSite: mode.toLowerCase()
});
const urlRequest2 = net.request({
url: serverUrl,
session: sess,
...extraOptions
});
const response2 = await getResponse(urlRequest2);
expect(response2.headers['x-cookie']).to.equal('same=site');
});
});
it('should be able to use the sessions cookie store safely across redirects', async () => {
const serverUrl = await respondOnce.toSingleURL(async (request, response) => {
response.statusCode = 302;
response.statusMessage = 'Moved';
const newUrl = await respondOnce.toSingleURL((req, res) => {
res.statusCode = 200;
res.statusMessage = 'OK';
res.setHeader('x-cookie', req.headers.cookie!);
res.end();
});
response.setHeader('x-cookie', request.headers.cookie!);
response.setHeader('location', newUrl.replace('127.0.0.1', 'localhost'));
response.end();
});
const sess = session.fromPartition(`cookie-tests-${Math.random()}`);
const cookie127Val = `${Date.now()}-127`;
const cookieLocalVal = `${Date.now()}-local`;
const localhostUrl = serverUrl.replace('127.0.0.1', 'localhost');
expect(localhostUrl).to.not.equal(serverUrl);
// cookies with lax or strict same-site settings will not
// persist after redirects. no_restriction must be used
await Promise.all([
sess.cookies.set({
url: serverUrl,
name: 'wild_cookie',
sameSite: 'no_restriction',
value: cookie127Val
}), sess.cookies.set({
url: localhostUrl,
name: 'wild_cookie',
sameSite: 'no_restriction',
value: cookieLocalVal
})
]);
const urlRequest = net.request({
url: serverUrl,
session: sess,
...extraOptions
});
urlRequest.on('redirect', (status, method, url, headers) => {
// The initial redirect response should have received the 127 value here
expect(headers['x-cookie'][0]).to.equal(`wild_cookie=${cookie127Val}`);
urlRequest.followRedirect();
});
const response = await getResponse(urlRequest);
// We expect the server to have received the localhost value here
// The original request was to a 127.0.0.1 URL
// That request would have the cookie127Val cookie attached
// The request is then redirect to a localhost URL (different site)
// Because we are using the session cookie store it should do the safe / secure thing
// and attach the cookies for the new target domain
expect(response.headers['x-cookie']).to.equal(`wild_cookie=${cookieLocalVal}`);
});
});
}
it('should be able correctly filter out cookies that are secure', async () => {
const sess = session.fromPartition(`cookie-tests-${Math.random()}`);
await Promise.all([
sess.cookies.set({
url: 'https://electronjs.org',
domain: 'electronjs.org',
name: 'cookie1',
value: '1',
secure: true
}),
sess.cookies.set({
url: 'https://electronjs.org',
domain: 'electronjs.org',
name: 'cookie2',
value: '2',
secure: false
})
]);
const secureCookies = await sess.cookies.get({
secure: true
});
expect(secureCookies).to.have.lengthOf(1);
expect(secureCookies[0].name).to.equal('cookie1');
const cookies = await sess.cookies.get({
secure: false
});
expect(cookies).to.have.lengthOf(1);
expect(cookies[0].name).to.equal('cookie2');
});
it('should be able correctly filter out cookies that are session', async () => {
const sess = session.fromPartition(`cookie-tests-${Math.random()}`);
await Promise.all([
sess.cookies.set({
url: 'https://electronjs.org',
domain: 'electronjs.org',
name: 'cookie1',
value: '1'
}),
sess.cookies.set({
url: 'https://electronjs.org',
domain: 'electronjs.org',
name: 'cookie2',
value: '2',
expirationDate: Math.round(Date.now() / 1000) + 10000
})
]);
const sessionCookies = await sess.cookies.get({
session: true
});
expect(sessionCookies).to.have.lengthOf(1);
expect(sessionCookies[0].name).to.equal('cookie1');
const cookies = await sess.cookies.get({
session: false
});
expect(cookies).to.have.lengthOf(1);
expect(cookies[0].name).to.equal('cookie2');
});
it('should be able correctly filter out cookies that are httpOnly', async () => {
const sess = session.fromPartition(`cookie-tests-${Math.random()}`);
await Promise.all([
sess.cookies.set({
url: 'https://electronjs.org',
domain: 'electronjs.org',
name: 'cookie1',
value: '1',
httpOnly: true
}),
sess.cookies.set({
url: 'https://electronjs.org',
domain: 'electronjs.org',
name: 'cookie2',
value: '2',
httpOnly: false
})
]);
const httpOnlyCookies = await sess.cookies.get({
httpOnly: true
});
expect(httpOnlyCookies).to.have.lengthOf(1);
expect(httpOnlyCookies[0].name).to.equal('cookie1');
const cookies = await sess.cookies.get({
httpOnly: false
});
expect(cookies).to.have.lengthOf(1);
expect(cookies[0].name).to.equal('cookie2');
});
describe('when {"credentials":"omit"}', () => {
it('should not send cookies');
it('should not store cookies');
});
it('should set sec-fetch-site to same-origin for request from same origin', async () => {
const serverUrl = await respondOnce.toSingleURL((request, response) => {
expect(request.headers['sec-fetch-site']).to.equal('same-origin');
response.statusCode = 200;
response.statusMessage = 'OK';
response.end();
});
const urlRequest = net.request({
url: serverUrl,
origin: serverUrl
});
await collectStreamBody(await getResponse(urlRequest));
});
it('should set sec-fetch-site to same-origin for request with the same origin header', async () => {
const serverUrl = await respondOnce.toSingleURL((request, response) => {
expect(request.headers['sec-fetch-site']).to.equal('same-origin');
response.statusCode = 200;
response.statusMessage = 'OK';
response.end();
});
const urlRequest = net.request({
url: serverUrl
});
urlRequest.setHeader('Origin', serverUrl);
await collectStreamBody(await getResponse(urlRequest));
});
it('should set sec-fetch-site to cross-site for request from other origin', async () => {
const serverUrl = await respondOnce.toSingleURL((request, response) => {
expect(request.headers['sec-fetch-site']).to.equal('cross-site');
response.statusCode = 200;
response.statusMessage = 'OK';
response.end();
});
const urlRequest = net.request({
url: serverUrl,
origin: 'https://not-exists.com'
});
await collectStreamBody(await getResponse(urlRequest));
});
it('should not send sec-fetch-user header by default', async () => {
const serverUrl = await respondOnce.toSingleURL((request, response) => {
expect(request.headers).not.to.have.property('sec-fetch-user');
response.statusCode = 200;
response.statusMessage = 'OK';
response.end();
});
const urlRequest = net.request({
url: serverUrl
});
await collectStreamBody(await getResponse(urlRequest));
});
it('should set sec-fetch-user to ?1 if requested', async () => {
const serverUrl = await respondOnce.toSingleURL((request, response) => {
expect(request.headers['sec-fetch-user']).to.equal('?1');
response.statusCode = 200;
response.statusMessage = 'OK';
response.end();
});
const urlRequest = net.request({
url: serverUrl
});
urlRequest.setHeader('sec-fetch-user', '?1');
await collectStreamBody(await getResponse(urlRequest));
});
it('should set sec-fetch-mode to no-cors by default', async () => {
const serverUrl = await respondOnce.toSingleURL((request, response) => {
expect(request.headers['sec-fetch-mode']).to.equal('no-cors');
response.statusCode = 200;
response.statusMessage = 'OK';
response.end();
});
const urlRequest = net.request({
url: serverUrl
});
await collectStreamBody(await getResponse(urlRequest));
});
['navigate', 'cors', 'no-cors', 'same-origin'].forEach((mode) => {
it(`should set sec-fetch-mode to ${mode} if requested`, async () => {
const serverUrl = await respondOnce.toSingleURL((request, response) => {
expect(request.headers['sec-fetch-mode']).to.equal(mode);
response.statusCode = 200;
response.statusMessage = 'OK';
response.end();
});
const urlRequest = net.request({
url: serverUrl,
origin: serverUrl
});
urlRequest.setHeader('sec-fetch-mode', mode);
await collectStreamBody(await getResponse(urlRequest));
});
});
it('should set sec-fetch-dest to empty by default', async () => {
const serverUrl = await respondOnce.toSingleURL((request, response) => {
expect(request.headers['sec-fetch-dest']).to.equal('empty');
response.statusCode = 200;
response.statusMessage = 'OK';
response.end();
});
const urlRequest = net.request({
url: serverUrl
});
await collectStreamBody(await getResponse(urlRequest));
});
[
'empty', 'audio', 'audioworklet', 'document', 'embed', 'font',
'frame', 'iframe', 'image', 'manifest', 'object', 'paintworklet',
'report', 'script', 'serviceworker', 'style', 'track', 'video',
'worker', 'xslt'
].forEach((dest) => {
it(`should set sec-fetch-dest to ${dest} if requested`, async () => {
const serverUrl = await respondOnce.toSingleURL((request, response) => {
expect(request.headers['sec-fetch-dest']).to.equal(dest);
response.statusCode = 200;
response.statusMessage = 'OK';
response.end();
});
const urlRequest = net.request({
url: serverUrl,
origin: serverUrl
});
urlRequest.setHeader('sec-fetch-dest', dest);
await collectStreamBody(await getResponse(urlRequest));
});
});
2019-11-25 20:56:18 +00:00
it('should be able to abort an HTTP request before first write', async () => {
const serverUrl = await respondOnce.toSingleURL((request, response) => {
2020-03-20 20:28:31 +00:00
response.end();
expect.fail('Unexpected request event');
});
2019-06-14 23:26:07 +00:00
2020-03-20 20:28:31 +00:00
const urlRequest = net.request(serverUrl);
2019-11-25 20:56:18 +00:00
urlRequest.on('response', () => {
2020-03-20 20:28:31 +00:00
expect.fail('unexpected response event');
});
const aborted = once(urlRequest, 'abort');
2020-03-20 20:28:31 +00:00
urlRequest.abort();
urlRequest.write('');
urlRequest.end();
await aborted;
});
2019-06-14 23:26:07 +00:00
it('it should be able to abort an HTTP request before request end', async () => {
2020-03-20 20:28:31 +00:00
let requestReceivedByServer = false;
let urlRequest: ClientRequest | null = null;
const serverUrl = await respondOnce.toSingleURL(() => {
2020-03-20 20:28:31 +00:00
requestReceivedByServer = true;
urlRequest!.abort();
});
let requestAbortEventEmitted = false;
2019-06-14 23:26:07 +00:00
2020-03-20 20:28:31 +00:00
urlRequest = net.request(serverUrl);
urlRequest.on('response', () => {
2020-03-20 20:28:31 +00:00
expect.fail('Unexpected response event');
});
urlRequest.on('finish', () => {
2020-03-20 20:28:31 +00:00
expect.fail('Unexpected finish event');
});
urlRequest.on('error', () => {
2020-03-20 20:28:31 +00:00
expect.fail('Unexpected error event');
});
urlRequest.on('abort', () => {
2020-03-20 20:28:31 +00:00
requestAbortEventEmitted = true;
});
2019-06-14 23:26:07 +00:00
const p = once(urlRequest, 'close');
urlRequest.chunkedEncoding = true;
urlRequest.write(randomString(kOneKiloByte));
await p;
2020-03-20 20:28:31 +00:00
expect(requestReceivedByServer).to.equal(true);
expect(requestAbortEventEmitted).to.equal(true);
});
2019-06-14 23:26:07 +00:00
2019-11-25 20:56:18 +00:00
it('it should be able to abort an HTTP request after request end and before response', async () => {
2020-03-20 20:28:31 +00:00
let requestReceivedByServer = false;
let urlRequest: ClientRequest | null = null;
2019-11-25 20:56:18 +00:00
const serverUrl = await respondOnce.toSingleURL((request, response) => {
2020-03-20 20:28:31 +00:00
requestReceivedByServer = true;
urlRequest!.abort();
2019-06-14 23:26:07 +00:00
process.nextTick(() => {
2020-03-20 20:28:31 +00:00
response.statusCode = 200;
response.statusMessage = 'OK';
response.end();
});
});
let requestFinishEventEmitted = false;
urlRequest = net.request(serverUrl);
2019-11-25 20:56:18 +00:00
urlRequest.on('response', () => {
2020-03-20 20:28:31 +00:00
expect.fail('Unexpected response event');
});
2019-11-25 20:56:18 +00:00
urlRequest.on('finish', () => {
2020-03-20 20:28:31 +00:00
requestFinishEventEmitted = true;
});
2019-11-25 20:56:18 +00:00
urlRequest.on('error', () => {
2020-03-20 20:28:31 +00:00
expect.fail('Unexpected error event');
});
urlRequest.end(randomString(kOneKiloByte));
await once(urlRequest, 'abort');
2020-03-20 20:28:31 +00:00
expect(requestFinishEventEmitted).to.equal(true);
expect(requestReceivedByServer).to.equal(true);
});
2019-06-14 23:26:07 +00:00
2019-11-25 20:56:18 +00:00
it('it should be able to abort an HTTP request after response start', async () => {
2020-03-20 20:28:31 +00:00
let requestReceivedByServer = false;
2019-11-25 20:56:18 +00:00
const serverUrl = await respondOnce.toSingleURL((request, response) => {
2020-03-20 20:28:31 +00:00
requestReceivedByServer = true;
response.statusCode = 200;
response.statusMessage = 'OK';
response.write(randomString(kOneKiloByte));
});
let requestFinishEventEmitted = false;
let requestResponseEventEmitted = false;
let responseCloseEventEmitted = false;
const urlRequest = net.request(serverUrl);
2019-11-25 20:56:18 +00:00
urlRequest.on('response', (response) => {
2020-03-20 20:28:31 +00:00
requestResponseEventEmitted = true;
const statusCode = response.statusCode;
expect(statusCode).to.equal(200);
response.on('data', () => {});
2019-11-25 20:56:18 +00:00
response.on('end', () => {
2020-03-20 20:28:31 +00:00
expect.fail('Unexpected end event');
});
2019-11-25 20:56:18 +00:00
response.on('error', () => {
2020-03-20 20:28:31 +00:00
expect.fail('Unexpected error event');
});
2019-11-25 20:56:18 +00:00
response.on('close' as any, () => {
2020-03-20 20:28:31 +00:00
responseCloseEventEmitted = true;
});
urlRequest.abort();
});
2019-11-25 20:56:18 +00:00
urlRequest.on('finish', () => {
2020-03-20 20:28:31 +00:00
requestFinishEventEmitted = true;
});
2019-11-25 20:56:18 +00:00
urlRequest.on('error', () => {
2020-03-20 20:28:31 +00:00
expect.fail('Unexpected error event');
});
urlRequest.end(randomString(kOneKiloByte));
await once(urlRequest, 'abort');
2020-03-20 20:28:31 +00:00
expect(requestFinishEventEmitted).to.be.true('request should emit "finish" event');
expect(requestReceivedByServer).to.be.true('request should be received by the server');
expect(requestResponseEventEmitted).to.be.true('"response" event should be emitted');
expect(responseCloseEventEmitted).to.be.true('response should emit "close" event');
});
2019-06-14 23:26:07 +00:00
2019-11-25 20:56:18 +00:00
it('abort event should be emitted at most once', async () => {
2020-03-20 20:28:31 +00:00
let requestReceivedByServer = false;
let urlRequest: ClientRequest | null = null;
2019-11-25 20:56:18 +00:00
const serverUrl = await respondOnce.toSingleURL(() => {
2020-03-20 20:28:31 +00:00
requestReceivedByServer = true;
urlRequest!.abort();
urlRequest!.abort();
});
let requestFinishEventEmitted = false;
let abortsEmitted = 0;
urlRequest = net.request(serverUrl);
2019-11-25 20:56:18 +00:00
urlRequest.on('response', () => {
2020-03-20 20:28:31 +00:00
expect.fail('Unexpected response event');
});
2019-11-25 20:56:18 +00:00
urlRequest.on('finish', () => {
2020-03-20 20:28:31 +00:00
requestFinishEventEmitted = true;
});
2019-11-25 20:56:18 +00:00
urlRequest.on('error', () => {
2020-03-20 20:28:31 +00:00
expect.fail('Unexpected error event');
});
2019-11-25 20:56:18 +00:00
urlRequest.on('abort', () => {
2020-03-20 20:28:31 +00:00
abortsEmitted++;
});
urlRequest.end(randomString(kOneKiloByte));
await once(urlRequest, 'abort');
2020-03-20 20:28:31 +00:00
expect(requestFinishEventEmitted).to.be.true('request should emit "finish" event');
expect(requestReceivedByServer).to.be.true('request should be received by server');
expect(abortsEmitted).to.equal(1, 'request should emit exactly 1 "abort" event');
});
2019-06-14 23:26:07 +00:00
it('should allow to read response body from non-2xx response', async () => {
2020-03-20 20:28:31 +00:00
const bodyData = randomString(kOneKiloByte);
const serverUrl = await respondOnce.toSingleURL((request, response) => {
2020-03-20 20:28:31 +00:00
response.statusCode = 404;
response.end(bodyData);
});
2020-03-20 20:28:31 +00:00
const urlRequest = net.request(serverUrl);
const bodyCheckPromise = getResponse(urlRequest).then(r => {
2020-03-20 20:28:31 +00:00
expect(r.statusCode).to.equal(404);
return r;
}).then(collectStreamBody).then(receivedBodyData => {
2020-03-20 20:28:31 +00:00
expect(receivedBodyData.toString()).to.equal(bodyData);
});
const eventHandlers = Promise.all([
bodyCheckPromise,
once(urlRequest, 'close')
2020-03-20 20:28:31 +00:00
]);
2020-03-20 20:28:31 +00:00
urlRequest.end();
2020-03-20 20:28:31 +00:00
await eventHandlers;
});
describe('webRequest', () => {
2019-06-14 23:26:07 +00:00
afterEach(() => {
2020-03-20 20:28:31 +00:00
session.defaultSession.webRequest.onBeforeRequest(null);
});
2019-06-14 23:26:07 +00:00
it('Should throw when invalid filters are passed', () => {
expect(() => {
session.defaultSession.webRequest.onBeforeRequest(
{ urls: ['*://www.googleapis.com'] },
2020-03-20 20:28:31 +00:00
(details, callback) => { callback({ cancel: false }); }
);
}).to.throw('Invalid url pattern *://www.googleapis.com: Empty path.');
expect(() => {
session.defaultSession.webRequest.onBeforeRequest(
{ urls: ['*://www.googleapis.com/', '*://blahblah.dev'] },
2020-03-20 20:28:31 +00:00
(details, callback) => { callback({ cancel: false }); }
);
}).to.throw('Invalid url pattern *://blahblah.dev: Empty path.');
});
it('Should not throw when valid filters are passed', () => {
expect(() => {
session.defaultSession.webRequest.onBeforeRequest(
{ urls: ['*://www.googleapis.com/'] },
2020-03-20 20:28:31 +00:00
(details, callback) => { callback({ cancel: false }); }
);
}).to.not.throw();
});
it('Requests should be intercepted by webRequest module', async () => {
2020-03-20 20:28:31 +00:00
const requestUrl = '/requestUrl';
const redirectUrl = '/redirectUrl';
let requestIsRedirected = false;
const serverUrl = await respondOnce.toURL(redirectUrl, (request, response) => {
2020-03-20 20:28:31 +00:00
requestIsRedirected = true;
response.end();
});
let requestIsIntercepted = false;
session.defaultSession.webRequest.onBeforeRequest(
(details, callback) => {
2019-06-14 23:26:07 +00:00
if (details.url === `${serverUrl}${requestUrl}`) {
2020-03-20 20:28:31 +00:00
requestIsIntercepted = true;
2019-06-14 23:26:07 +00:00
// Disabled due to false positive in StandardJS
// eslint-disable-next-line standard/no-callback-literal
callback({
redirectURL: `${serverUrl}${redirectUrl}`
2020-03-20 20:28:31 +00:00
});
2019-06-14 23:26:07 +00:00
} else {
callback({
cancel: false
2020-03-20 20:28:31 +00:00
});
2019-06-14 23:26:07 +00:00
}
2020-03-20 20:28:31 +00:00
});
2019-06-14 23:26:07 +00:00
2020-03-20 20:28:31 +00:00
const urlRequest = net.request(`${serverUrl}${requestUrl}`);
const response = await getResponse(urlRequest);
2020-03-20 20:28:31 +00:00
expect(response.statusCode).to.equal(200);
await collectStreamBody(response);
expect(requestIsRedirected).to.be.true('The server should receive a request to the forward URL');
expect(requestIsIntercepted).to.be.true('The request should be intercepted by the webRequest module');
});
it('should to able to create and intercept a request using a custom session object', async () => {
2020-03-20 20:28:31 +00:00
const requestUrl = '/requestUrl';
const redirectUrl = '/redirectUrl';
const customPartitionName = `custom-partition-${Math.random()}`;
2020-03-20 20:28:31 +00:00
let requestIsRedirected = false;
const serverUrl = await respondOnce.toURL(redirectUrl, (request, response) => {
2020-03-20 20:28:31 +00:00
requestIsRedirected = true;
response.end();
});
session.defaultSession.webRequest.onBeforeRequest(() => {
2020-03-20 20:28:31 +00:00
expect.fail('Request should not be intercepted by the default session');
});
2020-03-20 20:28:31 +00:00
const customSession = session.fromPartition(customPartitionName, { cache: false });
let requestIsIntercepted = false;
customSession.webRequest.onBeforeRequest((details, callback) => {
if (details.url === `${serverUrl}${requestUrl}`) {
2020-03-20 20:28:31 +00:00
requestIsIntercepted = true;
// Disabled due to false positive in StandardJS
// eslint-disable-next-line standard/no-callback-literal
callback({
redirectURL: `${serverUrl}${redirectUrl}`
2020-03-20 20:28:31 +00:00
});
} else {
callback({
cancel: false
2020-03-20 20:28:31 +00:00
});
}
2020-03-20 20:28:31 +00:00
});
const urlRequest = net.request({
url: `${serverUrl}${requestUrl}`,
session: customSession
2020-03-20 20:28:31 +00:00
});
const response = await getResponse(urlRequest);
expect(response.statusCode).to.equal(200);
await collectStreamBody(response);
expect(requestIsRedirected).to.be.true('The server should receive a request to the forward URL');
expect(requestIsIntercepted).to.be.true('The request should be intercepted by the webRequest module');
});
2019-06-14 23:26:07 +00:00
it('should to able to create and intercept a request using a custom partition name', async () => {
2020-03-20 20:28:31 +00:00
const requestUrl = '/requestUrl';
const redirectUrl = '/redirectUrl';
const customPartitionName = `custom-partition-${Math.random()}`;
2020-03-20 20:28:31 +00:00
let requestIsRedirected = false;
const serverUrl = await respondOnce.toURL(redirectUrl, (request, response) => {
2020-03-20 20:28:31 +00:00
requestIsRedirected = true;
response.end();
});
session.defaultSession.webRequest.onBeforeRequest(() => {
2020-03-20 20:28:31 +00:00
expect.fail('Request should not be intercepted by the default session');
});
2019-06-14 23:26:07 +00:00
2020-03-20 20:28:31 +00:00
const customSession = session.fromPartition(customPartitionName, { cache: false });
let requestIsIntercepted = false;
customSession.webRequest.onBeforeRequest((details, callback) => {
if (details.url === `${serverUrl}${requestUrl}`) {
2020-03-20 20:28:31 +00:00
requestIsIntercepted = true;
// Disabled due to false positive in StandardJS
// eslint-disable-next-line standard/no-callback-literal
callback({
redirectURL: `${serverUrl}${redirectUrl}`
2020-03-20 20:28:31 +00:00
});
} else {
callback({
cancel: false
2020-03-20 20:28:31 +00:00
});
}
2020-03-20 20:28:31 +00:00
});
const urlRequest = net.request({
url: `${serverUrl}${requestUrl}`,
partition: customPartitionName
2020-03-20 20:28:31 +00:00
});
const response = await getResponse(urlRequest);
expect(response.statusCode).to.equal(200);
await collectStreamBody(response);
expect(requestIsRedirected).to.be.true('The server should receive a request to the forward URL');
expect(requestIsIntercepted).to.be.true('The request should be intercepted by the webRequest module');
});
});
2019-06-14 23:26:07 +00:00
it('should throw when calling getHeader without a name', () => {
expect(() => {
2020-03-20 20:28:31 +00:00
(net.request({ url: 'https://test' }).getHeader as any)();
}).to.throw(/`name` is required for getHeader\(name\)/);
2019-06-14 23:26:07 +00:00
expect(() => {
2020-03-20 20:28:31 +00:00
net.request({ url: 'https://test' }).getHeader(null as any);
}).to.throw(/`name` is required for getHeader\(name\)/);
});
2019-06-14 23:26:07 +00:00
it('should throw when calling removeHeader without a name', () => {
expect(() => {
2020-03-20 20:28:31 +00:00
(net.request({ url: 'https://test' }).removeHeader as any)();
}).to.throw(/`name` is required for removeHeader\(name\)/);
2019-06-14 23:26:07 +00:00
expect(() => {
2020-03-20 20:28:31 +00:00
net.request({ url: 'https://test' }).removeHeader(null as any);
}).to.throw(/`name` is required for removeHeader\(name\)/);
});
2019-06-14 23:26:07 +00:00
it('should follow redirect when no redirect handler is provided', async () => {
2020-03-20 20:28:31 +00:00
const requestUrl = '/302';
const serverUrl = await respondOnce.toRoutes({
'/302': (request, response) => {
2020-03-20 20:28:31 +00:00
response.statusCode = 302;
response.setHeader('Location', '/200');
response.end();
2019-06-14 23:26:07 +00:00
},
'/200': (request, response) => {
2020-03-20 20:28:31 +00:00
response.statusCode = 200;
response.end();
2019-11-01 20:37:02 +00:00
}
2020-03-20 20:28:31 +00:00
});
const urlRequest = net.request({
url: `${serverUrl}${requestUrl}`
2020-03-20 20:28:31 +00:00
});
const response = await getResponse(urlRequest);
expect(response.statusCode).to.equal(200);
});
2019-06-14 23:26:07 +00:00
it('should follow redirect chain when no redirect handler is provided', async () => {
const serverUrl = await respondOnce.toRoutes({
2019-06-14 23:26:07 +00:00
'/redirectChain': (request, response) => {
2020-03-20 20:28:31 +00:00
response.statusCode = 302;
response.setHeader('Location', '/302');
response.end();
2019-06-14 23:26:07 +00:00
},
'/302': (request, response) => {
2020-03-20 20:28:31 +00:00
response.statusCode = 302;
response.setHeader('Location', '/200');
response.end();
2019-06-14 23:26:07 +00:00
},
'/200': (request, response) => {
2020-03-20 20:28:31 +00:00
response.statusCode = 200;
response.end();
2019-11-01 20:37:02 +00:00
}
2020-03-20 20:28:31 +00:00
});
const urlRequest = net.request({
url: `${serverUrl}/redirectChain`
2020-03-20 20:28:31 +00:00
});
const response = await getResponse(urlRequest);
expect(response.statusCode).to.equal(200);
});
2019-06-14 23:26:07 +00:00
2019-11-25 20:56:18 +00:00
it('should not follow redirect when request is canceled in redirect handler', async () => {
const serverUrl = await respondOnce.toSingleURL((request, response) => {
2020-03-20 20:28:31 +00:00
response.statusCode = 302;
response.setHeader('Location', '/200');
response.end();
});
2019-11-25 20:56:18 +00:00
const urlRequest = net.request({
url: serverUrl
2020-03-20 20:28:31 +00:00
});
urlRequest.end();
urlRequest.on('redirect', () => { urlRequest.abort(); });
urlRequest.on('error', () => {});
await once(urlRequest, 'abort');
2020-03-20 20:28:31 +00:00
});
2019-06-14 23:26:07 +00:00
it('should not follow redirect when mode is error', async () => {
const serverUrl = await respondOnce.toSingleURL((request, response) => {
2020-03-20 20:28:31 +00:00
response.statusCode = 302;
response.setHeader('Location', '/200');
response.end();
});
const urlRequest = net.request({
url: serverUrl,
redirect: 'error'
2020-03-20 20:28:31 +00:00
});
urlRequest.end();
await once(urlRequest, 'error');
2020-03-20 20:28:31 +00:00
});
2019-11-25 20:56:18 +00:00
it('should follow redirect when handler calls callback', async () => {
const serverUrl = await respondOnce.toRoutes({
2019-06-14 23:26:07 +00:00
'/redirectChain': (request, response) => {
2020-03-20 20:28:31 +00:00
response.statusCode = 302;
response.setHeader('Location', '/302');
response.end();
2019-06-14 23:26:07 +00:00
},
'/302': (request, response) => {
2020-03-20 20:28:31 +00:00
response.statusCode = 302;
response.setHeader('Location', '/200');
response.end();
2019-06-14 23:26:07 +00:00
},
'/200': (request, response) => {
2020-03-20 20:28:31 +00:00
response.statusCode = 200;
response.end();
2019-11-01 20:37:02 +00:00
}
2020-03-20 20:28:31 +00:00
});
const urlRequest = net.request({ url: `${serverUrl}/redirectChain`, redirect: 'manual' });
const redirects: string[] = [];
2019-11-25 20:56:18 +00:00
urlRequest.on('redirect', (status, method, url) => {
2020-03-20 20:28:31 +00:00
redirects.push(url);
urlRequest.followRedirect();
});
const response = await getResponse(urlRequest);
expect(response.statusCode).to.equal(200);
2019-11-25 20:56:18 +00:00
expect(redirects).to.deep.equal([
`${serverUrl}/302`,
2019-11-25 20:56:18 +00:00
`${serverUrl}/200`
2020-03-20 20:28:31 +00:00
]);
});
2019-06-14 23:26:07 +00:00
it('should throw if given an invalid session option', () => {
expect(() => {
net.request({
url: 'https://foo',
session: 1 as any
2020-03-20 20:28:31 +00:00
});
}).to.throw('`session` should be an instance of the Session class');
});
2019-06-14 23:26:07 +00:00
it('should throw if given an invalid partition option', () => {
expect(() => {
net.request({
url: 'https://foo',
partition: 1 as any
2020-03-20 20:28:31 +00:00
});
}).to.throw('`partition` should be a string');
});
2019-06-14 23:26:07 +00:00
it('should be able to create a request with options', async () => {
2020-03-20 20:28:31 +00:00
const customHeaderName = 'Some-Custom-Header-Name';
const customHeaderValue = 'Some-Customer-Header-Value';
const serverUrlUnparsed = await respondOnce.toURL('/', (request, response) => {
2020-03-20 20:28:31 +00:00
expect(request.method).to.equal('GET');
expect(request.headers[customHeaderName.toLowerCase()]).to.equal(customHeaderValue);
response.statusCode = 200;
response.statusMessage = 'OK';
response.end();
});
const serverUrl = url.parse(serverUrlUnparsed);
const options = {
port: serverUrl.port ? parseInt(serverUrl.port, 10) : undefined,
hostname: '127.0.0.1',
headers: { [customHeaderName]: customHeaderValue }
2020-03-20 20:28:31 +00:00
};
const urlRequest = net.request(options);
const response = await getResponse(urlRequest);
expect(response.statusCode).to.be.equal(200);
await collectStreamBody(response);
});
2019-06-14 23:26:07 +00:00
it('should be able to pipe a readable stream into a net request', async () => {
2020-03-20 20:28:31 +00:00
const bodyData = randomString(kOneMegaByte);
let netRequestReceived = false;
let netRequestEnded = false;
2019-06-14 23:26:07 +00:00
const [nodeServerUrl, netServerUrl] = await Promise.all([
2019-06-14 23:26:07 +00:00
respondOnce.toSingleURL((request, response) => response.end(bodyData)),
respondOnce.toSingleURL((request, response) => {
2020-03-20 20:28:31 +00:00
netRequestReceived = true;
let receivedBodyData = '';
2019-06-14 23:26:07 +00:00
request.on('data', (chunk) => {
2020-03-20 20:28:31 +00:00
receivedBodyData += chunk.toString();
});
2019-06-14 23:26:07 +00:00
request.on('end', (chunk: Buffer | undefined) => {
2020-03-20 20:28:31 +00:00
netRequestEnded = true;
2019-06-14 23:26:07 +00:00
if (chunk) {
2020-03-20 20:28:31 +00:00
receivedBodyData += chunk.toString();
2019-06-14 23:26:07 +00:00
}
2020-03-20 20:28:31 +00:00
expect(receivedBodyData).to.be.equal(bodyData);
response.end();
});
2019-06-14 23:26:07 +00:00
})
2020-03-20 20:28:31 +00:00
]);
const nodeRequest = http.request(nodeServerUrl);
const nodeResponse = await getResponse(nodeRequest as any) as any as http.ServerResponse;
const netRequest = net.request(netServerUrl);
const responsePromise = once(netRequest, 'response');
// TODO(@MarshallOfSound) - FIXME with #22730
2020-03-20 20:28:31 +00:00
nodeResponse.pipe(netRequest as any);
const [netResponse] = await responsePromise;
expect(netResponse.statusCode).to.equal(200);
await collectStreamBody(netResponse);
expect(netRequestReceived).to.be.true('net request received');
expect(netRequestEnded).to.be.true('net request ended');
});
2019-06-14 23:26:07 +00:00
it('should report upload progress', async () => {
const serverUrl = await respondOnce.toSingleURL((request, response) => {
2020-03-20 20:28:31 +00:00
response.end();
});
const netRequest = net.request({ url: serverUrl, method: 'POST' });
2020-05-18 17:22:48 +00:00
expect(netRequest.getUploadProgress()).to.have.property('active', false);
2020-03-20 20:28:31 +00:00
netRequest.end(Buffer.from('hello'));
const [position, total] = await once(netRequest, 'upload-progress');
2020-03-20 20:28:31 +00:00
expect(netRequest.getUploadProgress()).to.deep.equal({ active: true, started: true, current: position, total });
});
2019-11-25 20:56:18 +00:00
it('should emit error event on server socket destroy', async () => {
const serverUrl = await respondOnce.toSingleURL((request) => {
2020-03-20 20:28:31 +00:00
request.socket.destroy();
});
const urlRequest = net.request(serverUrl);
urlRequest.end();
const [error] = await once(urlRequest, 'error');
2020-03-20 20:28:31 +00:00
expect(error.message).to.equal('net::ERR_EMPTY_RESPONSE');
});
2019-11-25 20:56:18 +00:00
it('should emit error event on server request destroy', async () => {
const serverUrl = await respondOnce.toSingleURL((request, response) => {
2020-03-20 20:28:31 +00:00
request.destroy();
response.end();
});
const urlRequest = net.request(serverUrl);
urlRequest.end(randomBuffer(kOneMegaByte));
const [error] = await once(urlRequest, 'error');
expect(error.message).to.be.oneOf(['net::ERR_FAILED', 'net::ERR_CONNECTION_RESET', 'net::ERR_CONNECTION_ABORTED']);
2020-03-20 20:28:31 +00:00
});
2019-11-25 20:56:18 +00:00
it('should not emit any event after close', async () => {
const serverUrl = await respondOnce.toSingleURL((request, response) => {
2020-03-20 20:28:31 +00:00
response.end();
});
2019-11-25 20:56:18 +00:00
2020-03-20 20:28:31 +00:00
const urlRequest = net.request(serverUrl);
urlRequest.end();
2019-11-25 20:56:18 +00:00
await once(urlRequest, 'close');
2019-11-25 20:56:18 +00:00
await new Promise((resolve, reject) => {
['finish', 'abort', 'close', 'error'].forEach(evName => {
urlRequest.on(evName as any, () => {
2020-03-20 20:28:31 +00:00
reject(new Error(`Unexpected ${evName} event`));
});
});
setTimeout(50).then(resolve);
2020-03-20 20:28:31 +00:00
});
});
it('should remove the referer header when no referrer url specified', async () => {
const serverUrl = await respondOnce.toSingleURL((request, response) => {
expect(request.headers.referer).to.equal(undefined);
response.statusCode = 200;
response.statusMessage = 'OK';
response.end();
});
const urlRequest = net.request(serverUrl);
urlRequest.end();
const response = await getResponse(urlRequest);
expect(response.statusCode).to.equal(200);
await collectStreamBody(response);
});
it('should set the referer header when a referrer url specified', async () => {
const referrerURL = 'https://www.electronjs.org/';
const serverUrl = await respondOnce.toSingleURL((request, response) => {
expect(request.headers.referer).to.equal(referrerURL);
response.statusCode = 200;
response.statusMessage = 'OK';
response.end();
});
2023-02-20 20:57:38 +00:00
// The referrerPolicy must be unsafe-url because the referrer's origin
// doesn't match the loaded page. With the default referrer policy
// (strict-origin-when-cross-origin), the request will be canceled by the
// network service when the referrer header is invalid.
// See:
// - https://source.chromium.org/chromium/chromium/src/+/main:net/url_request/url_request.cc;l=682-683;drc=ae587fa7cd2e5cc308ce69353ee9ce86437e5d41
// - https://source.chromium.org/chromium/chromium/src/+/main:services/network/public/mojom/network_context.mojom;l=316-318;drc=ae5c7fcf09509843c1145f544cce3a61874b9698
// - https://w3c.github.io/webappsec-referrer-policy/#determine-requests-referrer
const urlRequest = net.request({ url: serverUrl, referrerPolicy: 'unsafe-url' });
urlRequest.setHeader('referer', referrerURL);
urlRequest.end();
const response = await getResponse(urlRequest);
expect(response.statusCode).to.equal(200);
await collectStreamBody(response);
});
2020-03-20 20:28:31 +00:00
});
2019-06-14 23:26:07 +00:00
describe('IncomingMessage API', () => {
2019-11-25 20:56:18 +00:00
it('response object should implement the IncomingMessage API', async () => {
2020-03-20 20:28:31 +00:00
const customHeaderName = 'Some-Custom-Header-Name';
const customHeaderValue = 'Some-Customer-Header-Value';
2019-06-14 23:26:07 +00:00
2019-11-25 20:56:18 +00:00
const serverUrl = await respondOnce.toSingleURL((request, response) => {
2020-03-20 20:28:31 +00:00
response.statusCode = 200;
response.statusMessage = 'OK';
response.setHeader(customHeaderName, customHeaderValue);
response.end();
});
2019-06-14 23:26:07 +00:00
2020-03-20 20:28:31 +00:00
const urlRequest = net.request(serverUrl);
const response = await getResponse(urlRequest);
2019-06-14 23:26:07 +00:00
2020-03-20 20:28:31 +00:00
expect(response.statusCode).to.equal(200);
expect(response.statusMessage).to.equal('OK');
2019-06-14 23:26:07 +00:00
2020-03-20 20:28:31 +00:00
const headers = response.headers;
expect(headers).to.be.an('object');
const headerValue = headers[customHeaderName.toLowerCase()];
expect(headerValue).to.equal(customHeaderValue);
2019-06-14 23:26:07 +00:00
const rawHeaders = response.rawHeaders;
expect(rawHeaders).to.be.an('array');
expect(rawHeaders[0]).to.equal(customHeaderName);
expect(rawHeaders[1]).to.equal(customHeaderValue);
2020-03-20 20:28:31 +00:00
const httpVersion = response.httpVersion;
expect(httpVersion).to.be.a('string').and.to.have.lengthOf.at.least(1);
2019-06-14 23:26:07 +00:00
2020-03-20 20:28:31 +00:00
const httpVersionMajor = response.httpVersionMajor;
expect(httpVersionMajor).to.be.a('number').and.to.be.at.least(1);
2019-06-14 23:26:07 +00:00
2020-03-20 20:28:31 +00:00
const httpVersionMinor = response.httpVersionMinor;
expect(httpVersionMinor).to.be.a('number').and.to.be.at.least(0);
2019-11-25 20:56:18 +00:00
2020-03-20 20:28:31 +00:00
await collectStreamBody(response);
});
2019-06-14 23:26:07 +00:00
2019-11-25 20:56:18 +00:00
it('should discard duplicate headers', async () => {
2020-03-20 20:28:31 +00:00
const includedHeader = 'max-forwards';
const discardableHeader = 'Max-Forwards';
2019-06-14 23:26:07 +00:00
2020-03-20 20:28:31 +00:00
const includedHeaderValue = 'max-fwds-val';
const discardableHeaderValue = 'max-fwds-val-two';
2019-06-14 23:26:07 +00:00
2019-11-25 20:56:18 +00:00
const serverUrl = await respondOnce.toSingleURL((request, response) => {
2020-03-20 20:28:31 +00:00
response.statusCode = 200;
response.statusMessage = 'OK';
response.setHeader(discardableHeader, discardableHeaderValue);
response.setHeader(includedHeader, includedHeaderValue);
response.end();
});
const urlRequest = net.request(serverUrl);
const response = await getResponse(urlRequest);
expect(response.statusCode).to.equal(200);
expect(response.statusMessage).to.equal('OK');
const headers = response.headers;
expect(headers).to.be.an('object');
expect(headers).to.have.property(includedHeader);
expect(headers).to.not.have.property(discardableHeader);
expect(headers[includedHeader]).to.equal(includedHeaderValue);
await collectStreamBody(response);
});
2019-06-14 23:26:07 +00:00
it('should join repeated non-discardable header values with ,', async () => {
2019-11-25 20:56:18 +00:00
const serverUrl = await respondOnce.toSingleURL((request, response) => {
2020-03-20 20:28:31 +00:00
response.statusCode = 200;
response.statusMessage = 'OK';
response.setHeader('referrer-policy', ['first-text', 'second-text']);
response.end();
});
const urlRequest = net.request(serverUrl);
const response = await getResponse(urlRequest);
expect(response.statusCode).to.equal(200);
expect(response.statusMessage).to.equal('OK');
const headers = response.headers;
expect(headers).to.be.an('object');
expect(headers).to.have.property('referrer-policy');
expect(headers['referrer-policy']).to.equal('first-text, second-text');
await collectStreamBody(response);
});
2019-06-14 23:26:07 +00:00
it('should not join repeated discardable header values with ,', async () => {
const serverUrl = await respondOnce.toSingleURL((request, response) => {
response.statusCode = 200;
response.statusMessage = 'OK';
response.setHeader('last-modified', ['yesterday', 'today']);
response.end();
});
const urlRequest = net.request(serverUrl);
const response = await getResponse(urlRequest);
expect(response.statusCode).to.equal(200);
expect(response.statusMessage).to.equal('OK');
const headers = response.headers;
expect(headers).to.be.an('object');
expect(headers).to.have.property('last-modified');
expect(headers['last-modified']).to.equal('yesterday');
await collectStreamBody(response);
});
it('should make set-cookie header an array even if single value', async () => {
const serverUrl = await respondOnce.toSingleURL((request, response) => {
response.statusCode = 200;
response.statusMessage = 'OK';
response.setHeader('set-cookie', 'chocolate-chip');
response.end();
});
const urlRequest = net.request(serverUrl);
const response = await getResponse(urlRequest);
expect(response.statusCode).to.equal(200);
expect(response.statusMessage).to.equal('OK');
const headers = response.headers;
expect(headers).to.be.an('object');
expect(headers).to.have.property('set-cookie');
expect(headers['set-cookie']).to.be.an('array');
expect(headers['set-cookie'][0]).to.equal('chocolate-chip');
await collectStreamBody(response);
});
it('should keep set-cookie header an array when an array', async () => {
const serverUrl = await respondOnce.toSingleURL((request, response) => {
response.statusCode = 200;
response.statusMessage = 'OK';
response.setHeader('set-cookie', ['chocolate-chip', 'oatmeal']);
response.end();
});
const urlRequest = net.request(serverUrl);
const response = await getResponse(urlRequest);
expect(response.statusCode).to.equal(200);
expect(response.statusMessage).to.equal('OK');
const headers = response.headers;
expect(headers).to.be.an('object');
expect(headers).to.have.property('set-cookie');
expect(headers['set-cookie']).to.be.an('array');
expect(headers['set-cookie'][0]).to.equal('chocolate-chip');
expect(headers['set-cookie'][1]).to.equal('oatmeal');
await collectStreamBody(response);
});
it('should lowercase header keys', async () => {
const serverUrl = await respondOnce.toSingleURL((request, response) => {
response.statusCode = 200;
response.statusMessage = 'OK';
response.setHeader('HEADER-KEY', ['header-value']);
response.setHeader('SeT-CookiE', ['chocolate-chip', 'oatmeal']);
response.setHeader('rEFERREr-pOLICy', ['first-text', 'second-text']);
response.setHeader('LAST-modified', 'yesterday');
response.end();
});
const urlRequest = net.request(serverUrl);
const response = await getResponse(urlRequest);
expect(response.statusCode).to.equal(200);
expect(response.statusMessage).to.equal('OK');
const headers = response.headers;
expect(headers).to.be.an('object');
expect(headers).to.have.property('header-key');
expect(headers).to.have.property('set-cookie');
expect(headers).to.have.property('referrer-policy');
expect(headers).to.have.property('last-modified');
await collectStreamBody(response);
});
it('should return correct raw headers', async () => {
const customHeaders: [string, string|string[]][] = [
['HEADER-KEY-ONE', 'header-value-one'],
['set-cookie', 'chocolate-chip'],
['header-key-two', 'header-value-two'],
['referrer-policy', ['first-text', 'second-text']],
['HEADER-KEY-THREE', 'header-value-three'],
['last-modified', ['first-text', 'second-text']],
['header-key-four', 'header-value-four']
];
const serverUrl = await respondOnce.toSingleURL((request, response) => {
response.statusCode = 200;
response.statusMessage = 'OK';
customHeaders.forEach((headerTuple) => {
response.setHeader(headerTuple[0], headerTuple[1]);
});
response.end();
});
const urlRequest = net.request(serverUrl);
const response = await getResponse(urlRequest);
expect(response.statusCode).to.equal(200);
expect(response.statusMessage).to.equal('OK');
const rawHeaders = response.rawHeaders;
expect(rawHeaders).to.be.an('array');
let rawHeadersIdx = 0;
customHeaders.forEach((headerTuple) => {
const headerKey = headerTuple[0];
const headerValues = Array.isArray(headerTuple[1]) ? headerTuple[1] : [headerTuple[1]];
headerValues.forEach((headerValue) => {
expect(rawHeaders[rawHeadersIdx]).to.equal(headerKey);
expect(rawHeaders[rawHeadersIdx + 1]).to.equal(headerValue);
rawHeadersIdx += 2;
});
});
await collectStreamBody(response);
});
it('should be able to pipe a net response into a writable stream', async () => {
2020-03-20 20:28:31 +00:00
const bodyData = randomString(kOneKiloByte);
let nodeRequestProcessed = false;
const [netServerUrl, nodeServerUrl] = await Promise.all([
2019-06-14 23:26:07 +00:00
respondOnce.toSingleURL((request, response) => response.end(bodyData)),
respondOnce.toSingleURL(async (request, response) => {
2020-03-20 20:28:31 +00:00
const receivedBodyData = await collectStreamBody(request);
expect(receivedBodyData).to.be.equal(bodyData);
nodeRequestProcessed = true;
response.end();
2019-06-14 23:26:07 +00:00
})
2020-03-20 20:28:31 +00:00
]);
const netRequest = net.request(netServerUrl);
const netResponse = await getResponse(netRequest);
const serverUrl = url.parse(nodeServerUrl);
const nodeOptions = {
method: 'POST',
path: serverUrl.path,
port: serverUrl.port
2020-03-20 20:28:31 +00:00
};
const nodeRequest = http.request(nodeOptions);
const nodeResponsePromise = once(nodeRequest, 'response');
// TODO(@MarshallOfSound) - FIXME with #22730
2020-03-20 20:28:31 +00:00
(netResponse as any).pipe(nodeRequest);
const [nodeResponse] = await nodeResponsePromise;
netRequest.end();
await collectStreamBody(nodeResponse);
expect(nodeRequestProcessed).to.equal(true);
});
it('should correctly throttle an incoming stream', async () => {
let numChunksSent = 0;
const serverUrl = await respondOnce.toSingleURL((request, response) => {
const data = randomString(kOneMegaByte);
const write = () => {
let ok = true;
do {
numChunksSent++;
if (numChunksSent > 30) return;
ok = response.write(data);
} while (ok);
response.once('drain', write);
};
write();
});
const urlRequest = net.request(serverUrl);
urlRequest.on('response', () => {});
urlRequest.end();
await setTimeout(2000);
// TODO(nornagon): I think this ought to max out at 20, but in practice
// it seems to exceed that sometimes. This is at 25 to avoid test flakes,
// but we should investigate if there's actually something broken here and
// if so fix it and reset this to max at 20, and if not then delete this
// comment.
expect(numChunksSent).to.be.at.most(25);
});
2020-03-20 20:28:31 +00:00
});
2019-06-14 23:26:07 +00:00
describe('net.isOnline', () => {
it('getter returns boolean', () => {
expect(net.isOnline()).to.be.a('boolean');
});
it('property returns boolean', () => {
expect(net.online).to.be.a('boolean');
});
});
2019-06-14 23:26:07 +00:00
describe('Stability and performance', () => {
it('should free unreferenced, never-started request objects without crash', (done) => {
2020-03-20 20:28:31 +00:00
net.request('https://test');
2019-06-14 23:26:07 +00:00
process.nextTick(() => {
const v8Util = process._linkedBinding('electron_common_v8_util');
2020-03-20 20:28:31 +00:00
v8Util.requestGarbageCollectionForTesting();
done();
});
});
2019-06-14 23:26:07 +00:00
it('should collect on-going requests without crash', async () => {
2020-03-20 20:28:31 +00:00
let finishResponse: (() => void) | null = null;
const serverUrl = await respondOnce.toSingleURL((request, response) => {
2020-03-20 20:28:31 +00:00
response.write(randomString(kOneKiloByte));
2019-06-14 23:26:07 +00:00
finishResponse = () => {
2020-03-20 20:28:31 +00:00
response.write(randomString(kOneKiloByte));
response.end();
};
});
const urlRequest = net.request(serverUrl);
const response = await getResponse(urlRequest);
process.nextTick(() => {
// Trigger a garbage collection.
const v8Util = process._linkedBinding('electron_common_v8_util');
2020-03-20 20:28:31 +00:00
v8Util.requestGarbageCollectionForTesting();
finishResponse!();
});
await collectStreamBody(response);
});
2019-06-14 23:26:07 +00:00
it('should collect unreferenced, ended requests without crash', async () => {
const serverUrl = await respondOnce.toSingleURL((request, response) => {
2020-03-20 20:28:31 +00:00
response.end();
});
const urlRequest = net.request(serverUrl);
process.nextTick(() => {
const v8Util = process._linkedBinding('electron_common_v8_util');
2020-03-20 20:28:31 +00:00
v8Util.requestGarbageCollectionForTesting();
});
const response = await getResponse(urlRequest);
await collectStreamBody(response);
});
it('should finish sending data when urlRequest is unreferenced', async () => {
const serverUrl = await respondOnce.toSingleURL(async (request, response) => {
2020-03-20 20:28:31 +00:00
const received = await collectStreamBodyBuffer(request);
expect(received.length).to.equal(kOneMegaByte);
response.end();
});
const urlRequest = net.request(serverUrl);
urlRequest.on('close', () => {
process.nextTick(() => {
const v8Util = process._linkedBinding('electron_common_v8_util');
2020-03-20 20:28:31 +00:00
v8Util.requestGarbageCollectionForTesting();
});
});
urlRequest.write(randomBuffer(kOneMegaByte));
const response = await getResponse(urlRequest);
await collectStreamBody(response);
});
it('should finish sending data when urlRequest is unreferenced for chunked encoding', async () => {
const serverUrl = await respondOnce.toSingleURL(async (request, response) => {
2020-03-20 20:28:31 +00:00
const received = await collectStreamBodyBuffer(request);
response.end();
expect(received.length).to.equal(kOneMegaByte);
});
const urlRequest = net.request(serverUrl);
urlRequest.chunkedEncoding = true;
urlRequest.write(randomBuffer(kOneMegaByte));
const response = await getResponse(urlRequest);
await collectStreamBody(response);
process.nextTick(() => {
const v8Util = process._linkedBinding('electron_common_v8_util');
2020-03-20 20:28:31 +00:00
v8Util.requestGarbageCollectionForTesting();
});
});
it('should finish sending data when urlRequest is unreferenced before close event for chunked encoding', async () => {
const serverUrl = await respondOnce.toSingleURL(async (request, response) => {
2020-03-20 20:28:31 +00:00
const received = await collectStreamBodyBuffer(request);
response.end();
expect(received.length).to.equal(kOneMegaByte);
});
const urlRequest = net.request(serverUrl);
urlRequest.chunkedEncoding = true;
urlRequest.write(randomBuffer(kOneMegaByte));
const v8Util = process._linkedBinding('electron_common_v8_util');
2020-03-20 20:28:31 +00:00
v8Util.requestGarbageCollectionForTesting();
await collectStreamBody(await getResponse(urlRequest));
});
2019-11-25 20:56:18 +00:00
it('should finish sending data when urlRequest is unreferenced', async () => {
const serverUrl = await respondOnce.toSingleURL(async (request, response) => {
2020-03-20 20:28:31 +00:00
const received = await collectStreamBodyBuffer(request);
response.end();
expect(received.length).to.equal(kOneMegaByte);
});
const urlRequest = net.request(serverUrl);
urlRequest.on('close', () => {
process.nextTick(() => {
const v8Util = process._linkedBinding('electron_common_v8_util');
2020-03-20 20:28:31 +00:00
v8Util.requestGarbageCollectionForTesting();
});
});
urlRequest.write(randomBuffer(kOneMegaByte));
await collectStreamBody(await getResponse(urlRequest));
});
2019-11-25 20:56:18 +00:00
it('should finish sending data when urlRequest is unreferenced for chunked encoding', async () => {
const serverUrl = await respondOnce.toSingleURL(async (request, response) => {
2020-03-20 20:28:31 +00:00
const received = await collectStreamBodyBuffer(request);
response.end();
expect(received.length).to.equal(kOneMegaByte);
});
const urlRequest = net.request(serverUrl);
urlRequest.on('close', () => {
process.nextTick(() => {
const v8Util = process._linkedBinding('electron_common_v8_util');
2020-03-20 20:28:31 +00:00
v8Util.requestGarbageCollectionForTesting();
});
});
urlRequest.chunkedEncoding = true;
urlRequest.write(randomBuffer(kOneMegaByte));
await collectStreamBody(await getResponse(urlRequest));
});
});
2023-02-20 20:57:38 +00:00
describe('net.fetch', () => {
// NB. there exist much more comprehensive tests for fetch() in the form of
// the WPT: https://github.com/web-platform-tests/wpt/tree/master/fetch
// It's possible to run these tests against net.fetch(), but the test
// harness to do so is quite complex and hasn't been munged to smoothly run
// inside the Electron test runner yet.
//
// In the meantime, here are some tests for basic functionality and
// Electron-specific behavior.
describe('basic', () => {
it('can fetch http urls', async () => {
const serverUrl = await respondOnce.toSingleURL((request, response) => {
response.end('test');
});
const resp = await net.fetch(serverUrl);
expect(resp.ok).to.be.true();
expect(await resp.text()).to.equal('test');
});
it('can upload a string body', async () => {
const serverUrl = await respondOnce.toSingleURL((request, response) => {
request.on('data', chunk => response.write(chunk));
request.on('end', () => response.end());
});
const resp = await net.fetch(serverUrl, {
method: 'POST',
body: 'anchovies'
});
expect(await resp.text()).to.equal('anchovies');
});
it('can read response as an array buffer', async () => {
const serverUrl = await respondOnce.toSingleURL((request, response) => {
request.on('data', chunk => response.write(chunk));
request.on('end', () => response.end());
});
const resp = await net.fetch(serverUrl, {
method: 'POST',
body: 'anchovies'
});
expect(new TextDecoder().decode(new Uint8Array(await resp.arrayBuffer()))).to.equal('anchovies');
});
it('can read response as form data', async () => {
const serverUrl = await respondOnce.toSingleURL((request, response) => {
response.setHeader('content-type', 'application/x-www-form-urlencoded');
response.end('foo=bar');
});
const resp = await net.fetch(serverUrl);
const result = await resp.formData();
expect(result.get('foo')).to.equal('bar');
});
it('should be able to use a session cookie store', async () => {
const serverUrl = await respondOnce.toSingleURL((request, response) => {
response.statusCode = 200;
response.statusMessage = 'OK';
response.setHeader('x-cookie', request.headers.cookie!);
response.end();
});
const sess = session.fromPartition(`cookie-tests-${Math.random()}`);
const cookieVal = `${Date.now()}`;
await sess.cookies.set({
url: serverUrl,
name: 'wild_cookie',
value: cookieVal
});
const response = await sess.fetch(serverUrl, {
credentials: 'include'
});
expect(response.headers.get('x-cookie')).to.equal(`wild_cookie=${cookieVal}`);
});
it('should reject promise on DNS failure', async () => {
const r = net.fetch('https://i.do.not.exist');
await expect(r).to.be.rejectedWith(/ERR_NAME_NOT_RESOLVED/);
});
it('should reject body promise when stream fails', async () => {
const serverUrl = await respondOnce.toSingleURL((request, response) => {
response.write('first chunk');
setTimeout().then(() => response.destroy());
2023-02-20 20:57:38 +00:00
});
const r = await net.fetch(serverUrl);
expect(r.status).to.equal(200);
await expect(r.text()).to.be.rejectedWith(/ERR_INCOMPLETE_CHUNKED_ENCODING/);
});
});
});
2020-03-20 20:28:31 +00:00
});