'use strict'; const jsDocPrefix = 'https://developer.mozilla.org/en-US/docs/Web/JavaScript/'; const jsDataStructuresUrl = `${jsDocPrefix}Data_structures`; const jsPrimitives = { boolean: 'Boolean', integer: 'Number', // Not a primitive, used for clarification. null: 'Null', number: 'Number', string: 'String', symbol: 'Symbol', undefined: 'Undefined' }; const jsGlobalObjectsUrl = `${jsDocPrefix}Reference/Global_Objects/`; const jsGlobalTypes = [ 'Array', 'ArrayBuffer', 'DataView', 'Date', 'Error', 'EvalError', 'Function', 'Map', 'Object', 'Promise', 'RangeError', 'ReferenceError', 'RegExp', 'Set', 'SharedArrayBuffer', 'SyntaxError', 'TypeError', 'TypedArray', 'URIError', 'Uint8Array', ]; const customTypesMap = { 'any': `${jsDataStructuresUrl}#Data_types`, 'this': `${jsDocPrefix}Reference/Operators/this`, 'AsyncIterator': 'https://tc39.github.io/ecma262/#sec-asynciterator-interface', 'bigint': 'https://github.com/tc39/proposal-bigint', 'Iterable': `${jsDocPrefix}Reference/Iteration_protocols#The_iterable_protocol`, 'Iterator': `${jsDocPrefix}Reference/Iteration_protocols#The_iterator_protocol`, 'Module Namespace Object': 'https://tc39.github.io/ecma262/#sec-module-namespace-exotic-objects', 'AsyncHook': 'async_hooks.html#async_hooks_async_hooks_createhook_callbacks', 'AsyncResource': 'async_hooks.html#async_hooks_class_asyncresource', 'brotli options': 'zlib.html#zlib_class_brotlioptions', 'Buffer': 'buffer.html#buffer_class_buffer', 'ChildProcess': 'child_process.html#child_process_class_childprocess', 'cluster.Worker': 'cluster.html#cluster_class_worker', 'Cipher': 'crypto.html#crypto_class_cipher', 'Decipher': 'crypto.html#crypto_class_decipher', 'DiffieHellman': 'crypto.html#crypto_class_diffiehellman', 'ECDH': 'crypto.html#crypto_class_ecdh', 'Hash': 'crypto.html#crypto_class_hash', 'Hmac': 'crypto.html#crypto_class_hmac', 'KeyObject': 'crypto.html#crypto_class_keyobject', 'Sign': 'crypto.html#crypto_class_sign', 'Verify': 'crypto.html#crypto_class_verify', 'crypto.constants': 'crypto.html#crypto_crypto_constants_1', 'dgram.Socket': 'dgram.html#dgram_class_dgram_socket', 'Domain': 'domain.html#domain_class_domain', 'import.meta': 'esm.html#esm_import_meta', 'EventEmitter': 'events.html#events_class_eventemitter', 'FileHandle': 'fs.html#fs_class_filehandle', 'fs.Dirent': 'fs.html#fs_class_fs_dirent', 'fs.FSWatcher': 'fs.html#fs_class_fs_fswatcher', 'fs.ReadStream': 'fs.html#fs_class_fs_readstream', 'fs.Stats': 'fs.html#fs_class_fs_stats', 'fs.WriteStream': 'fs.html#fs_class_fs_writestream', 'http.Agent': 'http.html#http_class_http_agent', 'http.ClientRequest': 'http.html#http_class_http_clientrequest', 'http.IncomingMessage': 'http.html#http_class_http_incomingmessage', 'http.Server': 'http.html#http_class_http_server', 'http.ServerResponse': 'http.html#http_class_http_serverresponse', 'ClientHttp2Session': 'http2.html#http2_class_clienthttp2session', 'ClientHttp2Stream': 'http2.html#http2_class_clienthttp2stream', 'HTTP/2 Headers Object': 'http2.html#http2_headers_object', 'HTTP/2 Settings Object': 'http2.html#http2_settings_object', 'http2.Http2ServerRequest': 'http2.html#http2_class_http2_http2serverrequest', 'http2.Http2ServerResponse': 'http2.html#http2_class_http2_http2serverresponse', 'Http2SecureServer': 'http2.html#http2_class_http2secureserver', 'Http2Server': 'http2.html#http2_class_http2server', 'Http2Session': 'http2.html#http2_class_http2session', 'Http2Stream': 'http2.html#http2_class_http2stream', 'ServerHttp2Stream': 'http2.html#http2_class_serverhttp2stream', 'https.Server': 'https.html#https_class_https_server', 'module': 'modules.html#modules_the_module_object', 'require': 'modules.html#modules_require_id', 'Handle': 'net.html#net_server_listen_handle_backlog_callback', 'net.Server': 'net.html#net_class_net_server', 'net.Socket': 'net.html#net_class_net_socket', 'os.constants.dlopen': 'os.html#os_dlopen_constants', 'Histogram': 'perf_hooks.html#perf_hooks_class_histogram', 'PerformanceEntry': 'perf_hooks.html#perf_hooks_class_performanceentry', 'PerformanceNodeTiming': 'perf_hooks.html#perf_hooks_class_performancenodetiming_extends_performanceentry', // eslint-disable-line max-len 'PerformanceObserver': 'perf_hooks.html#perf_hooks_class_performanceobserver', 'PerformanceObserverEntryList': 'perf_hooks.html#perf_hooks_class_performanceobserverentrylist', 'readline.Interface': 'readline.html#readline_class_interface', 'repl.REPLServer': 'repl.html#repl_class_replserver', 'Stream': 'stream.html#stream_stream', 'stream.Duplex': 'stream.html#stream_class_stream_duplex', 'stream.Readable': 'stream.html#stream_class_stream_readable', 'stream.Writable': 'stream.html#stream_class_stream_writable', 'Immediate': 'timers.html#timers_class_immediate', 'Timeout': 'timers.html#timers_class_timeout', 'Timer': 'timers.html#timers_timers', 'tls.SecureContext': 'tls.html#tls_tls_createsecurecontext_options', 'tls.Server': 'tls.html#tls_class_tls_server', 'tls.TLSSocket': 'tls.html#tls_class_tls_tlssocket', 'Tracing': 'tracing.html#tracing_tracing_object', 'URL': 'url.html#url_the_whatwg_url_api', 'URLSearchParams': 'url.html#url_class_urlsearchparams', 'vm.SourceTextModule': 'vm.html#vm_class_vm_sourcetextmodule', 'MessagePort': 'worker_threads.html#worker_threads_class_messageport', 'zlib options': 'zlib.html#zlib_class_options', }; const arrayPart = /(?:\[])+$/; function toLink(typeInput) { const typeLinks = []; typeInput = typeInput.replace('{', '').replace('}', ''); const typeTexts = typeInput.split('|'); typeTexts.forEach((typeText) => { typeText = typeText.trim(); if (typeText) { let typeUrl; // To support type[], type[][] etc., we store the full string // and use the bracket-less version to lookup the type URL. const typeTextFull = typeText; typeText = typeText.replace(arrayPart, ''); const primitive = jsPrimitives[typeText]; if (primitive !== undefined) { typeUrl = `${jsDataStructuresUrl}#${primitive}_type`; } else if (jsGlobalTypes.includes(typeText)) { typeUrl = `${jsGlobalObjectsUrl}${typeText}`; } else { typeUrl = customTypesMap[typeText]; } if (typeUrl) { typeLinks.push( `<${typeTextFull}>`); } else { throw new Error( `Unrecognized type: '${typeTextFull}'.\n` + "Please, edit the type or update the 'tools/doc/type-parser.js'." ); } } else { throw new Error(`Empty type slot: ${typeInput}`); } }); return typeLinks.length ? typeLinks.join(' | ') : typeInput; } module.exports = { toLink };