UNPKG

@loopback/docs

Version:
1,752 lines (1,751 loc) 118 kB
{ "metadata": { "toolPackage": "@microsoft/api-extractor", "toolVersion": "7.3.8", "schemaVersion": 1003, "oldestForwardsCompatibleVersion": 1001 }, "kind": "Package", "canonicalReference": "@loopback/testlab!", "docComment": "", "name": "@loopback/testlab", "members": [ { "kind": "EntryPoint", "canonicalReference": "@loopback/testlab!", "name": "", "members": [ { "kind": "TypeAlias", "canonicalReference": "@loopback/testlab!Client:type", "docComment": "", "excerptTokens": [ { "kind": "Content", "text": "export declare type " }, { "kind": "Reference", "text": "Client" }, { "kind": "Content", "text": " = " }, { "kind": "Reference", "text": "supertest" }, { "kind": "Content", "text": "." }, { "kind": "Reference", "text": "SuperTest" }, { "kind": "Content", "text": "<" }, { "kind": "Reference", "text": "supertest" }, { "kind": "Content", "text": "." }, { "kind": "Reference", "text": "Test" }, { "kind": "Content", "text": ">" }, { "kind": "Content", "text": ";" } ], "releaseTag": "Public", "name": "Client", "typeTokenRange": { "startIndex": 3, "endIndex": 11 } }, { "kind": "TypeAlias", "canonicalReference": "@loopback/testlab!ConfigRetval:type", "docComment": "", "excerptTokens": [ { "kind": "Content", "text": "export declare type " }, { "kind": "Reference", "text": "ConfigRetval" }, { "kind": "Content", "text": "<" }, { "kind": "Reference", "text": "T" }, { "kind": "Content", "text": " extends " }, { "kind": "Content", "text": "object" }, { "kind": "Content", "text": "> = " }, { "kind": "Reference", "text": "T" }, { "kind": "Content", "text": " & {\n " }, { "kind": "Reference", "text": "host" }, { "kind": "Content", "text": ": string;\n " }, { "kind": "Reference", "text": "port" }, { "kind": "Content", "text": ": number;\n} & " }, { "kind": "Reference", "text": "HttpsServerOptions" }, { "kind": "Content", "text": ";" } ], "releaseTag": "Public", "name": "ConfigRetval", "typeParameters": [ { "typeParameterName": "T", "constraintTokenRange": { "startIndex": 5, "endIndex": 6 }, "defaultTypeTokenRange": { "startIndex": 0, "endIndex": 0 } } ], "typeTokenRange": { "startIndex": 7, "endIndex": 14 } }, { "kind": "Function", "canonicalReference": "@loopback/testlab!createClientForHandler:function(1)", "docComment": "/**\n * Create a SuperTest client connected to an HTTP server listening on an ephemeral port and calling `handler` to handle incoming requests.\n *\n * @param - handler\n */\n", "excerptTokens": [ { "kind": "Content", "text": "export declare function " }, { "kind": "Reference", "text": "createClientForHandler" }, { "kind": "Content", "text": "(" }, { "kind": "Reference", "text": "handler" }, { "kind": "Content", "text": ": " }, { "kind": "Content", "text": "(" }, { "kind": "Reference", "text": "req" }, { "kind": "Content", "text": ": " }, { "kind": "Reference", "text": "http" }, { "kind": "Content", "text": "." }, { "kind": "Reference", "text": "IncomingMessage" }, { "kind": "Content", "text": ", " }, { "kind": "Reference", "text": "res" }, { "kind": "Content", "text": ": " }, { "kind": "Reference", "text": "http" }, { "kind": "Content", "text": "." }, { "kind": "Reference", "text": "ServerResponse" }, { "kind": "Content", "text": ") => void" }, { "kind": "Content", "text": "): " }, { "kind": "Reference", "text": "Client" }, { "kind": "Content", "text": ";" } ], "returnTypeTokenRange": { "startIndex": 19, "endIndex": 20 }, "releaseTag": "Public", "overloadIndex": 1, "parameters": [ { "parameterName": "handler", "parameterTypeTokenRange": { "startIndex": 5, "endIndex": 18 } } ], "name": "createClientForHandler" }, { "kind": "Function", "canonicalReference": "@loopback/testlab!createRestAppClient:function(1)", "docComment": "/**\n * Create a SuperTest client for a running RestApplication instance. It is the responsibility of the caller to ensure that the app is running and to stop the application after all tests are done.\n *\n * @param app - A running (listening) instance of a RestApplication.\n */\n", "excerptTokens": [ { "kind": "Content", "text": "export declare function " }, { "kind": "Reference", "text": "createRestAppClient" }, { "kind": "Content", "text": "(" }, { "kind": "Reference", "text": "app" }, { "kind": "Content", "text": ": " }, { "kind": "Reference", "text": "RestApplicationLike" }, { "kind": "Content", "text": "): " }, { "kind": "Reference", "text": "supertest" }, { "kind": "Content", "text": "." }, { "kind": "Reference", "text": "SuperTest" }, { "kind": "Content", "text": "<" }, { "kind": "Reference", "text": "supertest" }, { "kind": "Content", "text": "." }, { "kind": "Reference", "text": "Test" }, { "kind": "Content", "text": ">" }, { "kind": "Content", "text": ";" } ], "returnTypeTokenRange": { "startIndex": 7, "endIndex": 15 }, "releaseTag": "Public", "overloadIndex": 1, "parameters": [ { "parameterName": "app", "parameterTypeTokenRange": { "startIndex": 5, "endIndex": 6 } } ], "name": "createRestAppClient" }, { "kind": "Function", "canonicalReference": "@loopback/testlab!createStubInstance:function(1)", "docComment": "/**\n * Creates a new object with the given functions as the prototype and stubs all implemented functions.\n *\n * Note: The given constructor function is not invoked. See also the stub API.\n *\n * This is a helper method replacing `sinon.createStubInstance` and working around the limitations of TypeScript and Sinon, where Sinon is not able to list private/protected members in the type definition of the stub instance and therefore the stub instance cannot be assigned to places expecting TType. See also - https://github.com/Microsoft/TypeScript/issues/13543 - https://github.com/DefinitelyTyped/DefinitelyTyped/issues/14811\n *\n * @param constructor - Object or class to stub.\n *\n * @typeParam TType - Type being stubbed.\n *\n * @returns A stubbed version of the constructor, with an extra property `stubs` providing access to stub API for individual methods.\n */\n", "excerptTokens": [ { "kind": "Content", "text": "export declare function " }, { "kind": "Reference", "text": "createStubInstance" }, { "kind": "Content", "text": "<" }, { "kind": "Reference", "text": "TType" }, { "kind": "Content", "text": ">(" }, { "kind": "Reference", "text": "constructor" }, { "kind": "Content", "text": ": " }, { "kind": "Reference", "text": "sinon" }, { "kind": "Content", "text": "." }, { "kind": "Reference", "text": "StubbableType" }, { "kind": "Content", "text": "<" }, { "kind": "Reference", "text": "TType" }, { "kind": "Content", "text": ">" }, { "kind": "Content", "text": "): " }, { "kind": "Reference", "text": "StubbedInstanceWithSinonAccessor" }, { "kind": "Content", "text": "<" }, { "kind": "Reference", "text": "TType" }, { "kind": "Content", "text": ">" }, { "kind": "Content", "text": ";" } ], "returnTypeTokenRange": { "startIndex": 14, "endIndex": 18 }, "releaseTag": "Public", "overloadIndex": 1, "parameters": [ { "parameterName": "constructor", "parameterTypeTokenRange": { "startIndex": 7, "endIndex": 13 } } ], "typeParameters": [ { "typeParameterName": "TType", "constraintTokenRange": { "startIndex": 0, "endIndex": 0 }, "defaultTypeTokenRange": { "startIndex": 0, "endIndex": 0 } } ], "name": "createStubInstance" }, { "kind": "Function", "canonicalReference": "@loopback/testlab!createUnexpectedHttpErrorLogger:function(1)", "docComment": "/**\n * Creates a Logger that logs an Error if the HTTP status code is not expected\n *\n * @param expectedStatusCode - HTTP status code that is expected\n */\n", "excerptTokens": [ { "kind": "Content", "text": "export declare function " }, { "kind": "Reference", "text": "createUnexpectedHttpErrorLogger" }, { "kind": "Content", "text": "(" }, { "kind": "Reference", "text": "expectedStatusCode" }, { "kind": "Content", "text": "?: " }, { "kind": "Content", "text": "number" }, { "kind": "Content", "text": "): " }, { "kind": "Reference", "text": "LogError" }, { "kind": "Content", "text": ";" } ], "returnTypeTokenRange": { "startIndex": 7, "endIndex": 8 }, "releaseTag": "Public", "overloadIndex": 1, "parameters": [ { "parameterName": "expectedStatusCode", "parameterTypeTokenRange": { "startIndex": 5, "endIndex": 6 } } ], "name": "createUnexpectedHttpErrorLogger" }, { "kind": "Variable", "canonicalReference": "@loopback/testlab!expect:var", "docComment": "", "excerptTokens": [ { "kind": "Reference", "text": "expect" }, { "kind": "Content", "text": ": " }, { "kind": "Reference", "text": "Internal" } ], "releaseTag": "Public", "name": "expect", "variableTypeTokenRange": { "startIndex": 2, "endIndex": 3 } }, { "kind": "Interface", "canonicalReference": "@loopback/testlab!ExpressContextStub:interface", "docComment": "", "excerptTokens": [ { "kind": "Content", "text": "export interface " }, { "kind": "Reference", "text": "ExpressContextStub" }, { "kind": "Content", "text": " extends " }, { "kind": "Reference", "text": "HandlerContextStub" }, { "kind": "Content", "text": " " } ], "releaseTag": "Public", "name": "ExpressContextStub", "members": [ { "kind": "PropertySignature", "canonicalReference": "@loopback/testlab!ExpressContextStub#app:member", "docComment": "", "excerptTokens": [ { "kind": "Reference", "text": "app" }, { "kind": "Content", "text": ": " }, { "kind": "Reference", "text": "express" }, { "kind": "Content", "text": "." }, { "kind": "Reference", "text": "Application" }, { "kind": "Content", "text": ";" } ], "releaseTag": "Public", "name": "app", "propertyTypeTokenRange": { "startIndex": 2, "endIndex": 5 } }, { "kind": "PropertySignature", "canonicalReference": "@loopback/testlab!ExpressContextStub#request:member", "docComment": "", "excerptTokens": [ { "kind": "Reference", "text": "request" }, { "kind": "Content", "text": ": " }, { "kind": "Reference", "text": "express" }, { "kind": "Content", "text": "." }, { "kind": "Reference", "text": "Request" }, { "kind": "Content", "text": ";" } ], "releaseTag": "Public", "name": "request", "propertyTypeTokenRange": { "startIndex": 2, "endIndex": 5 } }, { "kind": "PropertySignature", "canonicalReference": "@loopback/testlab!ExpressContextStub#response:member", "docComment": "", "excerptTokens": [ { "kind": "Reference", "text": "response" }, { "kind": "Content", "text": ": " }, { "kind": "Reference", "text": "express" }, { "kind": "Content", "text": "." }, { "kind": "Reference", "text": "Response" }, { "kind": "Content", "text": ";" } ], "releaseTag": "Public", "name": "response", "propertyTypeTokenRange": { "startIndex": 2, "endIndex": 5 } }, { "kind": "PropertySignature", "canonicalReference": "@loopback/testlab!ExpressContextStub#result:member", "docComment": "", "excerptTokens": [ { "kind": "Reference", "text": "result" }, { "kind": "Content", "text": ": " }, { "kind": "Reference", "text": "Promise" }, { "kind": "Content", "text": "<" }, { "kind": "Reference", "text": "ObservedResponse" }, { "kind": "Content", "text": ">" }, { "kind": "Content", "text": ";" } ], "releaseTag": "Public", "name": "result", "propertyTypeTokenRange": { "startIndex": 2, "endIndex": 6 } } ], "extendsTokenRanges": [ { "startIndex": 3, "endIndex": 5 } ] }, { "kind": "Function", "canonicalReference": "@loopback/testlab!givenHttpServerConfig:function(1)", "docComment": "/**\n * Create an HTTP-server configuration that works well in test environments. - Ask the operating system to assign a free (ephemeral) port. - Use IPv4 localhost `127.0.0.1` to avoid known IPv6 issues in Docker-based environments like Travis-CI. - Provide default TLS key & cert when `protocol` is set to `https`.\n *\n * @param customConfig - Additional configuration options to apply.\n */\n", "excerptTokens": [ { "kind": "Content", "text": "export declare function " }, { "kind": "Reference", "text": "givenHttpServerConfig" }, { "kind": "Content", "text": "<" }, { "kind": "Reference", "text": "T" }, { "kind": "Content", "text": " extends " }, { "kind": "Content", "text": "object" }, { "kind": "Content", "text": ">(" }, { "kind": "Reference", "text": "customConfig" }, { "kind": "Content", "text": "?: " }, { "kind": "Reference", "text": "T" }, { "kind": "Content", "text": " & {\n " }, { "kind": "Reference", "text": "protocol" }, { "kind": "Content", "text": "?: string;\n}" }, { "kind": "Content", "text": "): " }, { "kind": "Reference", "text": "ConfigRetval" }, { "kind": "Content", "text": "<" }, { "kind": "Reference", "text": "T" }, { "kind": "Content", "text": ">" }, { "kind": "Content", "text": ";" } ], "returnTypeTokenRange": { "startIndex": 14, "endIndex": 18 }, "releaseTag": "Public", "overloadIndex": 1, "parameters": [ { "parameterName": "customConfig", "parameterTypeTokenRange": { "startIndex": 9, "endIndex": 13 } } ], "typeParameters": [ { "typeParameterName": "T", "constraintTokenRange": { "startIndex": 5, "endIndex": 6 }, "defaultTypeTokenRange": { "startIndex": 0, "endIndex": 0 } } ], "name": "givenHttpServerConfig" }, { "kind": "Interface", "canonicalReference": "@loopback/testlab!HandlerContextStub:interface", "docComment": "", "excerptTokens": [ { "kind": "Content", "text": "export interface " }, { "kind": "Reference", "text": "HandlerContextStub" }, { "kind": "Content", "text": " " } ], "releaseTag": "Public", "name": "HandlerContextStub", "members": [ { "kind": "PropertySignature", "canonicalReference": "@loopback/testlab!HandlerContextStub#request:member", "docComment": "", "excerptTokens": [ { "kind": "Reference", "text": "request" }, { "kind": "Content", "text": ": " }, { "kind": "Reference", "text": "IncomingMessage" }, { "kind": "Content", "text": ";" } ], "releaseTag": "Public", "name": "request", "propertyTypeTokenRange": { "startIndex": 2, "endIndex": 3 } }, { "kind": "PropertySignature", "canonicalReference": "@loopback/testlab!HandlerContextStub#response:member", "docComment": "", "excerptTokens": [ { "kind": "Reference", "text": "response" }, { "kind": "Content", "text": ": " }, { "kind": "Reference", "text": "ServerResponse" }, { "kind": "Content", "text": ";" } ], "releaseTag": "Public", "name": "response", "propertyTypeTokenRange": { "startIndex": 2, "endIndex": 3 } }, { "kind": "PropertySignature", "canonicalReference": "@loopback/testlab!HandlerContextStub#result:member", "docComment": "", "excerptTokens": [ { "kind": "Reference", "text": "result" }, { "kind": "Content", "text": ": " }, { "kind": "Reference", "text": "Promise" }, { "kind": "Content", "text": "<" }, { "kind": "Reference", "text": "ObservedResponse" }, { "kind": "Content", "text": ">" }, { "kind": "Content", "text": ";" } ], "releaseTag": "Public", "name": "result", "propertyTypeTokenRange": { "startIndex": 2, "endIndex": 6 } } ], "extendsTokenRanges": [] }, { "kind": "Function", "canonicalReference": "@loopback/testlab!httpGetAsync:function(1)", "docComment": "/**\n * Async wrapper for making HTTP GET requests\n *\n * @param - urlString\n */\n", "excerptTokens": [ { "kind": "Content", "text": "export declare function " }, { "kind": "Reference", "text": "httpGetAsync" }, { "kind": "Content", "text": "(" }, { "kind": "Reference", "text": "urlString" }, { "kind": "Content", "text": ": " }, { "kind": "Content", "text": "string" }, { "kind": "Content", "text": "): " }, { "kind": "Reference", "text": "Promise" }, { "kind": "Content", "text": "<" }, { "kind": "Reference", "text": "IncomingMessage" }, { "kind": "Content", "text": ">" }, { "kind": "Content", "text": ";" } ], "returnTypeTokenRange": { "startIndex": 7, "endIndex": 11 }, "releaseTag": "Public", "overloadIndex": 1, "parameters": [ { "parameterName": "urlString", "parameterTypeTokenRange": { "startIndex": 5, "endIndex": 6 } } ], "name": "httpGetAsync" }, { "kind": "Function", "canonicalReference": "@loopback/testlab!httpsGetAsync:function(1)", "docComment": "/**\n * Async wrapper for making HTTPS GET requests\n *\n * @param - urlString\n */\n", "excerptTokens": [ { "kind": "Content", "text": "export declare function " }, { "kind": "Reference", "text": "httpsGetAsync" }, { "kind": "Content", "text": "(" }, { "kind": "Reference", "text": "urlString" }, { "kind": "Content", "text": ": " }, { "kind": "Content", "text": "string" }, { "kind": "Content", "text": "): " }, { "kind": "Reference", "text": "Promise" }, { "kind": "Content", "text": "<" }, { "kind": "Reference", "text": "IncomingMessage" }, { "kind": "Content", "text": ">" }, { "kind": "Content", "text": ";" } ], "returnTypeTokenRange": { "startIndex": 7, "endIndex": 11 }, "releaseTag": "Public", "overloadIndex": 1, "parameters": [ { "parameterName": "urlString", "parameterTypeTokenRange": { "startIndex": 5, "endIndex": 6 } } ], "name": "httpsGetAsync" }, { "kind": "Variable", "canonicalReference": "@loopback/testlab!inject:var", "docComment": "", "excerptTokens": [ { "kind": "Reference", "text": "inject" }, { "kind": "Content", "text": ": " }, { "kind": "Content", "text": "(" }, { "kind": "Reference", "text": "dispatchFunc" }, { "kind": "Content", "text": ": " }, { "kind": "Reference", "text": "ShotListener" }, { "kind": "Content", "text": ", " }, { "kind": "Reference", "text": "options" }, { "kind": "Content", "text": ": " }, { "kind": "Reference", "text": "ShotRequestOptions" }, { "kind": "Content", "text": ") => " }, { "kind": "Reference", "text": "Promise" }, { "kind": "Content", "text": "<" }, { "kind": "Reference", "text": "ResponseObject" }, { "kind": "Content", "text": ">" } ], "releaseTag": "Public", "name": "inject", "variableTypeTokenRange": { "startIndex": 2, "endIndex": 15 } }, { "kind": "Function", "canonicalReference": "@loopback/testlab!itSkippedOnTravis:function(1)", "docComment": "/**\n * Helper function for skipping tests on Travis env - legacy variant supporting `it` only.\n *\n * @deprecated\n *\n * Use `skipOnTravis(it, name, fn)` instead.\n *\n * @param expectation - The test name (the first argument of `it` function).\n *\n * @param callback - The test function (the second argument of `it` function).\n */\n", "excerptTokens": [ { "kind": "Content", "text": "export declare function " }, { "kind": "Reference", "text": "itSkippedOnTravis" }, { "kind": "Content", "text": "(" }, { "kind": "Reference", "text": "expectation" }, { "kind": "Content", "text": ": " }, { "kind": "Content", "text": "string" }, { "kind": "Content", "text": ", " }, { "kind": "Reference", "text": "callback" }, { "kind": "Content", "text": "?: " }, { "kind": "Reference", "text": "TestFn" }, { "kind": "Content", "text": "): " }, { "kind": "Content", "text": "void" }, { "kind": "Content", "text": ";" } ], "returnTypeTokenRange": { "startIndex": 11, "endIndex": 12 }, "releaseTag": "Public", "overloadIndex": 1, "parameters": [ { "parameterName": "expectation", "parameterTypeTokenRange": { "startIndex": 5, "endIndex": 6 } }, { "parameterName": "callback", "parameterTypeTokenRange": { "startIndex": 9, "endIndex": 10 } } ], "name": "itSkippedOnTravis" }, { "kind": "TypeAlias", "canonicalReference": "@loopback/testlab!ObservedResponse:type", "docComment": "", "excerptTokens": [ { "kind": "Content", "text": "export declare type " }, { "kind": "Reference", "text": "ObservedResponse" }, { "kind": "Content", "text": " = " }, { "kind": "Reference", "text": "ResponseObject" }, { "kind": "Content", "text": ";" } ], "releaseTag": "Public", "name": "ObservedResponse", "typeTokenRange": { "startIndex": 3, "endIndex": 4 } }, { "kind": "Interface", "canonicalReference": "@loopback/testlab!RestApplicationLike:interface", "docComment": "", "excerptTokens": [ { "kind": "Content", "text": "export interface " }, { "kind": "Reference", "text": "RestApplicationLike" }, { "kind": "Content", "text": " " } ], "releaseTag": "Public", "name": "RestApplicationLike", "members": [ { "kind": "PropertySignature", "canonicalReference": "@loopback/testlab!RestApplicationLike#restServer:member", "docComment": "", "excerptTokens": [ { "kind": "Reference", "text": "restServer" }, { "kind": "Content", "text": ": " }, { "kind": "Reference", "text": "RestServerLike" }, { "kind": "Content", "text": ";" } ], "releaseTag": "Public", "name": "restServer", "propertyTypeTokenRange": { "startIndex": 2, "endIndex": 3 } } ], "extendsTokenRanges": [] }, { "kind": "Interface", "canonicalReference": "@loopback/testlab!RestServerLike:interface", "docComment": "", "excerptTokens": [ { "kind": "Content", "text": "export interface " }, { "kind": "Reference", "text": "RestServerLike" }, { "kind": "Content", "text": " " } ], "releaseTag": "Public", "name": "RestServerLike", "members": [ { "kind": "PropertySignature", "canonicalReference": "@loopback/testlab!RestServerLike#rootUrl:member", "docComment": "", "excerptTokens": [ { "kind": "Reference", "text": "rootUrl" }, { "kind": "Content", "text": "?: " }, { "kind": "Content", "text": "string" }, { "kind": "Content", "text": ";" } ], "releaseTag": "Public", "name": "rootUrl", "propertyTypeTokenRange": { "startIndex": 2, "endIndex": 3 } }, { "kind": "PropertySignature", "canonicalReference": "@loopback/testlab!RestServerLike#url:member", "docComment": "", "excerptTokens": [ { "kind": "Reference", "text": "url" }, { "kind": "Content", "text": "?: " }, { "kind": "Content", "text": "string" }, { "kind": "Content", "text": ";" } ], "releaseTag": "Public", "name": "url", "propertyTypeTokenRange": { "startIndex": 2, "endIndex": 3 } } ], "extendsTokenRanges": [] }, { "kind": "TypeAlias", "canonicalReference": "@loopback/testlab!ShotCallback:type", "docComment": "", "excerptTokens": [ { "kind": "Content", "text": "export declare type " }, { "kind": "Reference", "text": "ShotCallback" }, { "kind": "Content", "text": " = " }, { "kind": "Content", "text": "(" }, { "kind": "Reference", "text": "response" }, { "kind": "Content", "text": ": " }, { "kind": "Reference", "text": "ResponseObject" }, { "kind": "Content", "text": ") => void" }, { "kind": "Content", "text": ";" } ], "releaseTag": "Public", "name": "ShotCallback", "typeTokenRange": { "startIndex": 3, "endIndex": 8 } }, { "kind": "TypeAlias", "canonicalReference": "@loopback/testlab!ShotResponseCtor:type", "docComment": "", "excerptTokens": [ { "kind": "Content", "text": "export declare type " }, { "kind": "Reference", "text": "ShotResponseCtor" }, { "kind": "Content", "text": " = " }, { "kind": "Content", "text": "new (" }, { "kind": "Reference", "text": "request" }, { "kind": "Content", "text": ": " }, { "kind": "Reference", "text": "IncomingMessage" }, { "kind": "Content", "text": ", " }, { "kind": "Reference", "text": "onEnd" }, { "kind": "Content", "text": ": " }, { "kind": "Reference", "text": "ShotCallback" }, { "kind": "Content", "text": ") => " }, { "kind": "Reference", "text": "ServerResponse" }, { "kind": "Content", "text": ";" } ], "releaseTag": "Public", "name": "ShotResponseCtor", "typeTokenRange": { "startIndex": 3, "endIndex": 13 } }, { "kind": "Function", "canonicalReference": "@loopback/testlab!skipIf:function(1)", "docComment": "/**\n * Helper function for skipping tests when a certain condition is met.\n *\n * @param skip - Should the test case/suite be skipped?\n *\n * @param verb - The function to invoke to define the test case or the test suite, e.g. `it` or `describe`.\n *\n * @param name - The test name (the first argument of `verb` function).\n *\n * @param args - Additional arguments (framework specific), typically a function implementing the test.\n *\n * @example\n * ```ts\n * skipIf(\n * !features.freeFormProperties,\n * describe,\n * 'free-form properties (strict: false)',\n * () => {\n * // the tests\n * }\n * );\n * ```\n *\n */\n", "excerptTokens": [ { "kind": "Content", "text": "export declare function " }, { "kind": "Reference", "text": "skipIf" }, { "kind": "Content", "text": "<" }, { "kind": "Reference", "text": "ARGS" }, { "kind": "Content", "text": " extends " }, { "kind": "Content", "text": "unknown[]" }, { "kind": "Content", "text": ", " }, { "kind": "Reference", "text": "RETVAL" }, { "kind": "Content", "text": ">(" }, { "kind": "Reference", "text": "skip" }, { "kind": "Content", "text": ": " }, { "kind": "Content", "text": "boolean" }, { "kind": "Content", "text": ", " }, { "kind": "Reference", "text": "verb" }, { "kind": "Content", "text": ": " }, { "kind": "Reference", "text": "TestDefinition" }, { "kind": "Content", "text": "<" }, { "kind": "Reference", "text": "ARGS" }, { "kind": "Content", "text": ", " }, { "kind": "Reference", "text": "RETVAL" }, { "kind": "Content", "text": "> & {\n " }, { "kind": "Reference", "text": "skip" }, { "kind": "Content", "text": ": " }, { "kind": "Reference", "text": "TestDefinition" }, { "kind": "Content", "text": "<" }, { "kind": "Reference", "text": "ARGS" }, { "kind": "Content", "text": ", " }, { "kind": "Reference", "text": "RETVAL" }, { "kind": "Content", "text": ">;\n}" }, { "kind": "Content", "text": ", " }, { "kind": "Reference", "text": "name" }, { "kind": "Content", "text": ": " }, { "kind": "Content", "text": "string" }, { "kind": "Content", "text": ", ..." }, { "kind": "Reference", "text": "args" }, { "kind": "Content", "text": ": " }, { "kind": "Reference", "text": "ARGS" }, { "kind": "Content", "text": "): " }, { "kind": "Reference", "text": "RETVAL" }, { "kind": "Content", "text": ";" } ], "returnTypeTokenRange": { "startIndex": 38, "endIndex": 39 }, "releaseTag": "Public", "overloadIndex": 1, "parameters": [ { "parameterName": "skip", "parameterTypeTokenRange": { "startIndex": 11, "endIndex": 12 } }, { "parameterName": "verb", "parameterTypeTokenRange": { "startIndex": 15, "endIndex": 29 } }, { "parameterName": "name", "parameterTypeTokenRange": {