@eggjs/supertest 8.0.0

package/dist/esm/test.d.ts

@@ -0,0 +1,80 @@
+import type { Server } from 'node:net';
+import { Request, type Response } from 'superagent';
+import { AssertError } from './error/AssertError.js';
+export type TestApplication = Server | string;
+export type AssertFunction = (res: Response) => AssertError | void;
+export type CallbackFunction = (err: AssertError | Error | null, res: Response) => void;
+export type ResponseError = Error & {
+    syscall?: string;
+    code?: string;
+    status?: number;
+};
+export interface ExpectHeader {
+    name: string;
+    value: string | number | RegExp;
+}
+export declare class Test extends Request {
+    app: TestApplication;
+    _server: Server;
+    _asserts: AssertFunction[];
+    /**
+     * Initialize a new `Test` with the given `app`,
+     * request `method` and `path`.
+     */
+    constructor(app: TestApplication, method: string, path: string);
+    /**
+     * Returns a URL, extracted from a server.
+     *
+     * @return {String} URL address
+     * @private
+     */
+    protected serverAddress(app: Server, path: string): string;
+    /**
+     * Expectations:
+     *
+     * ```js
+     *   .expect(200)
+     *   .expect(200, fn)
+     *   .expect(200, body)
+     *   .expect('Some body')
+     *   .expect('Some body', fn)
+     *   .expect(['json array body', { key: 'val' }])
+     *   .expect('Content-Type', 'application/json')
+     *   .expect('Content-Type', 'application/json', fn)
+     *   .expect(fn)
+     *   .expect([200, 404])
+     * ```
+     *
+     * @return {Test} The current Test instance for chaining.
+     */
+    expect(a: number | string | RegExp | object | AssertFunction, b?: string | number | RegExp | CallbackFunction, c?: CallbackFunction): Test;
+    /**
+     * Defer invoking superagent's `.end()` until
+     * the server is listening.
+     */
+    end(fn: CallbackFunction): this;
+    /**
+     * Perform assertions and invoke `fn(err, res)`.
+     */
+    assert(resError: ResponseError | null, res: Response, fn: CallbackFunction): void;
+    /**
+     * Perform assertions on a response body and return an Error upon failure.
+     */
+    _assertBody(body: RegExp | string | number | object | null | undefined, res: Response): AssertError | undefined;
+    /**
+     * Perform assertions on a response header and return an Error upon failure.
+     */
+    _assertHeader(header: ExpectHeader, res: Response): AssertError | undefined;
+    /**
+     * Perform assertions on the response status and return an Error upon failure.
+     */
+    _assertStatus(status: number, res: Response): AssertError | undefined;
+    /**
+     * Perform assertions on the response status and return an Error upon failure.
+     */
+    _assertStatusArray(statusArray: number[], res: Response): AssertError | undefined;
+    /**
+     * Performs an assertion by calling a function and return an Error upon failure.
+     */
+    _assertFunction(fn: AssertFunction, res: Response): Error | undefined;
+}

package/dist/esm/test.js

@@ -0,0 +1,278 @@
+import { inspect } from 'node:util';
+import { STATUS_CODES } from 'node:http';
+import { Server as HttpsServer } from 'node:tls';
+import { deepStrictEqual } from 'node:assert';
+import { Request } from 'superagent';
+import { AssertError } from './error/AssertError.js';
+export class Test extends Request {
+    app;
+    _server;
+    _asserts = [];
+    /**
+     * Initialize a new `Test` with the given `app`,
+     * request `method` and `path`.
+     */
+    constructor(app, method, path) {
+        super(method.toUpperCase(), path);
+        this.redirects(0);
+        this.buffer();
+        this.app = app;
+        this.url = typeof app === 'string'
+            ? app + path
+            : this.serverAddress(app, path);
+    }
+    /**
+     * Returns a URL, extracted from a server.
+     *
+     * @return {String} URL address
+     * @private
+     */
+    serverAddress(app, path) {
+        const addr = app.address();
+        if (!addr) {
+            this._server = app.listen(0);
+        }
+        const port = app.address().port;
+        const protocol = (app instanceof HttpsServer || this._server instanceof HttpsServer) ? 'https' : 'http';
+        return `${protocol}://127.0.0.1:${port}${path}`;
+    }
+    /**
+     * Expectations:
+     *
+     * ```js
+     *   .expect(200)
+     *   .expect(200, fn)
+     *   .expect(200, body)
+     *   .expect('Some body')
+     *   .expect('Some body', fn)
+     *   .expect(['json array body', { key: 'val' }])
+     *   .expect('Content-Type', 'application/json')
+     *   .expect('Content-Type', 'application/json', fn)
+     *   .expect(fn)
+     *   .expect([200, 404])
+     * ```
+     *
+     * @return {Test} The current Test instance for chaining.
+     */
+    expect(a, b, c) {
+        // callback
+        if (typeof a === 'function') {
+            // .expect(fn)
+            this._asserts.push(wrapAssertFn(a));
+            return this;
+        }
+        if (typeof b === 'function') {
+            // .expect('Some body', fn)
+            this.end(b);
+        }
+        if (typeof c === 'function') {
+            // .expect('Content-Type', 'application/json', fn)
+            this.end(c);
+        }
+        // status
+        if (typeof a === 'number') {
+            this._asserts.push(wrapAssertFn(this._assertStatus.bind(this, a)));
+            // body
+            if (typeof b !== 'function' && arguments.length > 1) {
+                // .expect(200, 'body')
+                // .expect(200, null)
+                // .expect(200, 9999999)
+                this._asserts.push(wrapAssertFn(this._assertBody.bind(this, b)));
+            }
+            return this;
+        }
+        // multiple statuses
+        if (Array.isArray(a) && a.length > 0 && a.every(val => typeof val === 'number')) {
+            // .expect([200, 300])
+            this._asserts.push(wrapAssertFn(this._assertStatusArray.bind(this, a)));
+            return this;
+        }
+        // header field
+        if (typeof b === 'string' || typeof b === 'number' || b instanceof RegExp) {
+            // .expect('Content-Type', 'application/json')
+            // .expect('Content-Type', /json/)
+            this._asserts.push(wrapAssertFn(this._assertHeader.bind(this, { name: String(a), value: b })));
+            return this;
+        }
+        // body
+        // .expect('body')
+        // .expect(['json array body', { key: 'val' }])
+        // .expect(/foo/)
+        this._asserts.push(wrapAssertFn(this._assertBody.bind(this, a)));
+        return this;
+    }
+    /**
+     * Defer invoking superagent's `.end()` until
+     * the server is listening.
+     */
+    end(fn) {
+        const server = this._server;
+        super.end((err, res) => {
+            const localAssert = () => {
+                this.assert(err, res, fn);
+            };
+            if (server && '_handle' in server && server._handle) {
+                return server.close(localAssert);
+            }
+            localAssert();
+        });
+        return this;
+    }
+    /**
+     * Perform assertions and invoke `fn(err, res)`.
+     */
+    assert(resError, res, fn) {
+        let errorObj;
+        // check for unexpected network errors or server not running/reachable errors
+        // when there is no response and superagent sends back a System Error
+        // do not check further for other asserts, if any, in such case
+        // https://nodejs.org/api/errors.html#errors_common_system_errors
+        const sysErrors = {
+            ECONNREFUSED: 'Connection refused',
+            ECONNRESET: 'Connection reset by peer',
+            EPIPE: 'Broken pipe',
+            ETIMEDOUT: 'Operation timed out',
+        };
+        if (!res && resError) {
+            if (resError instanceof Error
+                && resError.syscall === 'connect'
+                && resError.code
+                && sysErrors[resError.code]) {
+                errorObj = new Error(resError.code + ': ' + sysErrors[resError.code]);
+            }
+            else {
+                errorObj = resError;
+            }
+        }
+        // asserts
+        for (let i = 0; i < this._asserts.length && !errorObj; i += 1) {
+            errorObj = this._assertFunction(this._asserts[i], res);
+        }
+        // set unexpected superagent error if no other error has occurred.
+        if (!errorObj && resError instanceof Error && (!res || resError.status !== res.status)) {
+            errorObj = resError;
+        }
+        fn.call(this, errorObj || null, res);
+    }
+    /**
+     * Perform assertions on a response body and return an Error upon failure.
+     */
+    _assertBody(body, res) {
+        const isRegexp = body instanceof RegExp;
+        // parsed
+        if (typeof body === 'object' && !isRegexp) {
+            try {
+                deepStrictEqual(body, res.body);
+            }
+            catch (err) {
+                const a = inspect(body);
+                const b = inspect(res.body);
+                return new AssertError('expected ' + a + ' response body, got ' + b, body, res.body, { cause: err });
+            }
+        }
+        else if (body !== res.text) {
+            // string
+            const a = inspect(body);
+            const b = inspect(res.text);
+            // regexp
+            if (isRegexp) {
+                if (!body.test(res.text)) {
+                    return new AssertError('expected body ' + b + ' to match ' + body, body, res.body);
+                }
+            }
+            else {
+                return new AssertError('expected ' + a + ' response body, got ' + b, body, res.body);
+            }
+        }
+    }
+    /**
+     * Perform assertions on a response header and return an Error upon failure.
+     */
+    _assertHeader(header, res) {
+        const field = header.name;
+        const actual = res.header[field.toLowerCase()];
+        const fieldExpected = header.value;
+        if (typeof actual === 'undefined') {
+            return new AssertError('expected "' + field + '" header field', header, actual);
+        }
+        // This check handles header values that may be a String or single element Array
+        if ((Array.isArray(actual) && actual.toString() === fieldExpected)
+            || fieldExpected === actual) {
+            return;
+        }
+        if (fieldExpected instanceof RegExp) {
+            if (!fieldExpected.test(actual)) {
+                return new AssertError('expected "' + field + '" matching '
+                    + fieldExpected + ', got "' + actual + '"', header, actual);
+            }
+        }
+        else {
+            return new AssertError('expected "' + field + '" of "' + fieldExpected + '", got "' + actual + '"', header, actual);
+        }
+    }
+    /**
+     * Perform assertions on the response status and return an Error upon failure.
+     */
+    _assertStatus(status, res) {
+        if (res.status !== status) {
+            const a = STATUS_CODES[status];
+            const b = STATUS_CODES[res.status];
+            return new AssertError('expected ' + status + ' "' + a + '", got ' + res.status + ' "' + b + '"', status, res.status);
+        }
+    }
+    /**
+     * Perform assertions on the response status and return an Error upon failure.
+     */
+    _assertStatusArray(statusArray, res) {
+        if (!statusArray.includes(res.status)) {
+            const b = STATUS_CODES[res.status];
+            const expectedList = statusArray.join(', ');
+            return new AssertError('expected one of "' + expectedList + '", got ' + res.status + ' "' + b + '"', statusArray, res.status);
+        }
+    }
+    /**
+     * Performs an assertion by calling a function and return an Error upon failure.
+     */
+    _assertFunction(fn, res) {
+        let err;
+        try {
+            err = fn(res);
+        }
+        catch (e) {
+            err = e;
+        }
+        if (err instanceof Error) {
+            return err;
+        }
+    }
+}
+/**
+ * Wraps an assert function into another.
+ * The wrapper function edit the stack trace of any assertion error, prepending a more useful stack to it.
+ *
+ * @param {Function} assertFn
+ * @return {Function} wrapped assert function
+ */
+function wrapAssertFn(assertFn) {
+    const savedStack = new Error().stack.split('\n').slice(3);
+    return (res) => {
+        let badStack;
+        let err;
+        try {
+            err = assertFn(res);
+        }
+        catch (e) {
+            err = e;
+        }
+        if (err instanceof Error && err.stack) {
+            badStack = err.stack.replace(err.message, '').split('\n').slice(1);
+            err.stack = [err.toString()]
+                .concat(savedStack)
+                .concat('----')
+                .concat(badStack)
+                .join('\n');
+        }
+        return err;
+    };
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidGVzdC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy90ZXN0LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxPQUFPLEVBQUUsTUFBTSxXQUFXLENBQUM7QUFDcEMsT0FBTyxFQUFFLFlBQVksRUFBRSxNQUFNLFdBQVcsQ0FBQztBQUN6QyxPQUFPLEVBQUUsTUFBTSxJQUFJLFdBQVcsRUFBRSxNQUFNLFVBQVUsQ0FBQztBQUVqRCxPQUFPLEVBQUUsZUFBZSxFQUFFLE1BQU0sYUFBYSxDQUFDO0FBQzlDLE9BQU8sRUFBRSxPQUFPLEVBQWlCLE1BQU0sWUFBWSxDQUFDO0FBQ3BELE9BQU8sRUFBRSxXQUFXLEVBQUUsTUFBTSx3QkFBd0IsQ0FBQztBQVlyRCxNQUFNLE9BQU8sSUFBSyxTQUFRLE9BQU87SUFDL0IsR0FBRyxDQUFrQjtJQUNyQixPQUFPLENBQVM7SUFDaEIsUUFBUSxHQUFxQixFQUFFLENBQUM7SUFFaEM7OztPQUdHO0lBQ0gsWUFBWSxHQUFvQixFQUFFLE1BQWMsRUFBRSxJQUFZO1FBQzVELEtBQUssQ0FBQyxNQUFNLENBQUMsV0FBVyxFQUFFLEVBQUUsSUFBSSxDQUFDLENBQUM7UUFFbEMsSUFBSSxDQUFDLFNBQVMsQ0FBQyxDQUFDLENBQUMsQ0FBQztRQUNsQixJQUFJLENBQUMsTUFBTSxFQUFFLENBQUM7UUFDZCxJQUFJLENBQUMsR0FBRyxHQUFHLEdBQUcsQ0FBQztRQUNmLElBQUksQ0FBQyxHQUFHLEdBQUcsT0FBTyxHQUFHLEtBQUssUUFBUTtZQUNoQyxDQUFDLENBQUMsR0FBRyxHQUFHLElBQUk7WUFDWixDQUFDLENBQUMsSUFBSSxDQUFDLGFBQWEsQ0FBQyxHQUFHLEVBQUUsSUFBSSxDQUFDLENBQUM7SUFDcEMsQ0FBQztJQUVEOzs7OztPQUtHO0lBQ08sYUFBYSxDQUFDLEdBQVcsRUFBRSxJQUFZO1FBQy9DLE1BQU0sSUFBSSxHQUFHLEdBQUcsQ0FBQyxPQUFPLEVBQUUsQ0FBQztR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

package/dist/esm/types.d.ts

@@ -0,0 +1,10 @@
+import type { RequestListener } from 'node:http';
+import type { Http2ServerRequest, Http2ServerResponse } from 'node:http2';
+import type { Server } from 'node:net';
+import type { AgentOptions as SAgentOptions } from 'superagent';
+export type H2RequestListener = (request: Http2ServerRequest, response: Http2ServerResponse) => void;
+export type H1RequestListener = RequestListener;
+export type App = Server | H1RequestListener | H2RequestListener | string;
+export interface AgentOptions extends SAgentOptions {
+    http2?: boolean;
+}

package/dist/esm/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHlwZXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvdHlwZXMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IiJ9

package/dist/package.json

@@ -0,0 +1,4 @@
+{
+  "name": "@eggjs/supertest",
+  "version": "8.0.0"
+}

package/package.json

@@ -0,0 +1,86 @@
+{
+  "name": "@eggjs/supertest",
+  "description": "SuperAgent driven library for testing HTTP servers",
+  "version": "8.0.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "author": "TJ Holowaychuk",
+  "keywords": [
+    "bdd",
+    "http",
+    "request",
+    "superagent",
+    "tdd",
+    "test",
+    "testing"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/eggjs/supertest.git"
+  },
+  "engines": {
+    "node": ">= 18.19.0"
+  },
+  "dependencies": {
+    "superagent": "^9.0.1"
+  },
+  "devDependencies": {
+    "@arethetypeswrong/cli": "^0.17.1",
+    "@eggjs/tsconfig": "1",
+    "@types/body-parser": "^1.19.5",
+    "@types/cookie-parser": "^1.4.8",
+    "@types/express": "^5.0.0",
+    "@types/mocha": "10",
+    "@types/node": "22",
+    "@types/superagent": "^8.1.9",
+    "body-parser": "^1.20.3",
+    "cookie-parser": "^1.4.6",
+    "egg-bin": "6",
+    "eslint": "8",
+    "eslint-config-egg": "14",
+    "express": "^4.18.2",
+    "nock": "^13.3.0",
+    "nyc": "^15.1.0",
+    "should": "^13.2.3",
+    "tshy": "3",
+    "tshy-after": "1",
+    "typescript": "5"
+  },
+  "scripts": {
+    "lint": "eslint --cache src test --ext .ts",
+    "pretest": "npm run lint -- --fix && npm run prepublishOnly",
+    "test": "egg-bin test",
+    "preci": "npm run lint && npm run prepublishOnly && attw --pack",
+    "ci": "egg-bin cov",
+    "prepublishOnly": "tshy && tshy-after"
+  },
+  "type": "module",
+  "tshy": {
+    "exports": {
+      ".": "./src/index.ts",
+      "./package.json": "./package.json"
+    }
+  },
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/esm/index.d.ts",
+        "default": "./dist/esm/index.js"
+      },
+      "require": {
+        "types": "./dist/commonjs/index.d.ts",
+        "default": "./dist/commonjs/index.js"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "types": "./dist/commonjs/index.d.ts",
+  "main": "./dist/commonjs/index.js",
+  "module": "./dist/esm/index.js"
+}

package/src/agent.ts

@@ -0,0 +1,93 @@
+import http from 'node:http';
+import http2 from 'node:http2';
+import type { Server } from 'node:net';
+import { agent as Agent } from 'superagent';
+import { Test } from './test.js';
+import type { AgentOptions, H1RequestListener, H2RequestListener, App } from './types.js';
+
+/**
+ * Initialize a new `TestAgent`.
+ *
+ * @param {Function|Server} app
+ * @param {Object} options
+ */
+
+export class TestAgent extends Agent {
+  app: Server | string;
+  _host: string;
+  #http2 = false;
+
+  constructor(appOrListener: App, options: AgentOptions = {}) {
+    super(options);
+    if (typeof appOrListener === 'function') {
+      if (options.http2) {
+        this.#http2 = true;
+        this.app = http2.createServer(appOrListener as H2RequestListener); // eslint-disable-line no-param-reassign
+      } else {
+        this.app = http.createServer(appOrListener as H1RequestListener); // eslint-disable-line no-param-reassign
+      }
+    } else {
+      this.app = appOrListener;
+    }
+  }
+
+  // set a host name
+  host(host: string) {
+    this._host = host;
+    return this;
+  }
+
+  // TestAgent.prototype.del = TestAgent.prototype.delete;
+
+  protected _testRequest(method: string, url: string) {
+    const req = new Test(this.app, method.toUpperCase(), url);
+    if (this.#http2) {
+      req.http2();
+    }
+
+    if (this._host) {
+      req.set('host', this._host);
+    }
+
+    const that = this as any;
+    // access not internal methods
+    req.on('response', that._saveCookies.bind(this));
+    req.on('redirect', that._saveCookies.bind(this));
+    req.on('redirect', that._attachCookies.bind(this, req));
+    that._setDefaults(req);
+    that._attachCookies(req);
+
+    return req;
+  }
+  delete(url: string) {
+    return this._testRequest('delete', url);
+  }
+  del(url: string) {
+    return this._testRequest('delete', url);
+  }
+  get(url: string) {
+    return this._testRequest('get', url);
+  }
+  head(url: string) {
+    return this._testRequest('head', url);
+  }
+  put(url: string) {
+    return this._testRequest('put', url);
+  }
+  post(url: string) {
+    return this._testRequest('post', url);
+  }
+  patch(url: string) {
+    return this._testRequest('patch', url);
+  }
+  options(url: string) {
+    return this._testRequest('options', url);
+  }
+}
+
+// allow keep use by `agent()`
+export const proxyAgent = new Proxy(TestAgent, {
+  apply(target, _, argumentsList) {
+    return new target(argumentsList[0], argumentsList[1]);
+  },
+});

package/src/error/AssertError.ts

@@ -0,0 +1,12 @@
+export class AssertError extends Error {
+  expected: any;
+  actual: any;
+
+  constructor(message: string, expected: any, actual: any, options?: ErrorOptions) {
+    super(message, options);
+    this.name = this.constructor.name;
+    this.expected = expected;
+    this.actual = actual;
+    Error.captureStackTrace(this, this.constructor);
+  }
+}

package/src/index.ts

@@ -0,0 +1,39 @@
+import { Request, RequestOptions } from './request.js';
+import { TestAgent, proxyAgent } from './agent.js';
+import type { App, AgentOptions } from './types.js';
+
+/**
+ * Test against the given `app`,
+ * returning a new `Test`.
+ */
+export function request(app: App, options: RequestOptions = {}) {
+  return new Request(app, options);
+}
+
+export {
+  Request, RequestOptions,
+  TestAgent,
+  // import { agent } from '@eggjs/supertest';
+  // agent()
+  proxyAgent as agent,
+};
+
+export * from './test.js';
+
+// import request from '@eggjs/supertest';
+// request()
+export default new Proxy(request, {
+  apply(target, _, argumentsList) {
+    return target(argumentsList[0], argumentsList[1]);
+  },
+  get(target, property, receiver) {
+    // import request from '@eggjs/supertest';
+    // request.agent()
+    if (property === 'agent') {
+      return proxyAgent;
+    }
+    return Reflect.get(target, property, receiver);
+  },
+}) as unknown as ((app: App, options?: RequestOptions) => Request) & {
+  agent: (app: App, options?: AgentOptions) => TestAgent;
+};