@types/node 8.5.8 → 8.5.9

node v8/README.md

@@ -8,7 +8,7 @@ This package contains type definitions for Node.js (http://nodejs.org/).
 Files were exported from https://www.github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/node/v8
 
 Additional Details
- * Last updated: Mon, 08 Jan 2018 16:04:00 GMT
+ * Last updated: Wed, 17 Jan 2018 22:17:28 GMT
  * Dependencies: none
  * Global values: Buffer, NodeJS, SlowBuffer, Symbol, __dirname, __filename, clearImmediate, clearInterval, clearTimeout, console, exports, global, module, process, require, setImmediate, setInterval, setTimeout
 

node v8/index.d.ts

@@ -19,12 +19,6 @@
 //                 Alberto Schiabel <https://github.com/jkomyno>
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
 
-/************************************************
-*                                               *
-*               Node.js v8.5.x API              *
-*                                               *
-************************************************/
-
 /** inspector module types */
 /// <reference path="./inspector.d.ts" />
 
@@ -145,6 +139,7 @@ interface NodeModule {
     loaded: boolean;
     parent: NodeModule | null;
     children: NodeModule[];
+    paths: string[];
 }
 
 declare var module: NodeModule;
@@ -1176,13 +1171,7 @@ declare module "cluster" {
         stdio?: any[];
         uid?: number;
         gid?: number;
-    }
-
-    export interface ClusterSetupMasterSettings {
-        exec?: string;  // default: process.argv[1]
-        args?: string[];  // default: process.argv.slice(2)
-        silent?: boolean;  // default: false
-        stdio?: any[];
+        inspectPort?: number | (() => number);
     }
 
     export interface Address {
@@ -1269,7 +1258,7 @@ declare module "cluster" {
         isWorker: boolean;
         // TODO: cluster.schedulingPolicy
         settings: ClusterSettings;
-        setupMaster(settings?: ClusterSetupMasterSettings): void;
+        setupMaster(settings?: ClusterSettings): void;
         worker?: Worker;
         workers?: {
             [index: string]: Worker | undefined
@@ -1346,7 +1335,7 @@ declare module "cluster" {
     export var isWorker: boolean;
     // TODO: cluster.schedulingPolicy
     export var settings: ClusterSettings;
-    export function setupMaster(settings?: ClusterSetupMasterSettings): void;
+    export function setupMaster(settings?: ClusterSettings): void;
     export var worker: Worker;
     export var workers: {
         [index: string]: Worker | undefined
@@ -1729,7 +1718,7 @@ declare module "os" {
     export function arch(): string;
     export function platform(): NodeJS.Platform;
     export function tmpdir(): string;
-    export var EOL: string;
+    export const EOL: string;
     export function endianness(): "BE" | "LE";
 }
 
@@ -1752,6 +1741,7 @@ declare module "https" {
         rejectUnauthorized?: boolean;
         NPNProtocols?: any;
         SNICallback?: (servername: string, cb: (err: Error | null, ctx: tls.SecureContext) => void) => void;
+        secureProtocol?: string;
     }
 
     export interface RequestOptions extends http.RequestOptions {
@@ -2342,7 +2332,19 @@ declare module "url" {
         query?: string | null | ParsedUrlQuery;
     }
 
-    export function parse(urlStr: string, parseQueryString?: boolean, slashesDenoteHost?: boolean): Url;
+    export interface UrlWithParsedQuery extends Url {
+        query: ParsedUrlQuery;
+    }
+
+    export interface UrlWithStringQuery extends Url {
+        query: string | null;
+    }
+
+    export function parse(urlStr: string): UrlWithStringQuery;
+    export function parse(urlStr: string, parseQueryString: false | undefined, slashesDenoteHost?: boolean): UrlWithStringQuery;
+    export function parse(urlStr: string, parseQueryString: true, slashesDenoteHost?: boolean): UrlWithParsedQuery;
+    export function parse(urlStr: string, parseQueryString: boolean, slashesDenoteHost?: boolean): Url;
+
     export function format(URL: URL, options?: URLFormatOptions): string;
     export function format(urlObject: UrlObject | string): string;
     export function resolve(from: string, to: string): string;
@@ -4573,7 +4575,6 @@ declare module "path" {
          */
         name: string;
     }
-
     export interface FormatInputPathObject {
         /**
          * The root of the path such as '/' or 'c:\'
@@ -4620,7 +4621,7 @@ declare module "path" {
      *
      * @param pathSegments string paths to join.  Non-string arguments are ignored.
      */
-    export function resolve(...pathSegments: any[]): string;
+    export function resolve(...pathSegments: string[]): string;
     /**
      * Determines whether {path} is an absolute path. An absolute path will always resolve to the same location, regardless of the working directory.
      *
@@ -4686,7 +4687,7 @@ declare module "path" {
         export var sep: string;
         export var delimiter: string;
         export function parse(p: string): ParsedPath;
-        export function format(pP: ParsedPath): string;
+        export function format(pP: FormatInputPathObject): string;
     }
 
     export module win32 {
@@ -4701,7 +4702,7 @@ declare module "path" {
         export var sep: string;
         export var delimiter: string;
         export function parse(p: string): ParsedPath;
-        export function format(pP: ParsedPath): string;
+        export function format(pP: FormatInputPathObject): string;
     }
 }
 
@@ -6920,195 +6921,195 @@ declare module "http2" {
 }
 
 declare module "perf_hooks" {
-	export interface PerformanceEntry {
-		/**
-		 * The total number of milliseconds elapsed for this entry.
-		 * This value will not be meaningful for all Performance Entry types.
-		 */
-		readonly duration: number;
-
-		/**
-		 * The name of the performance entry.
-		 */
-		readonly name: string;
-
-		/**
-		 * The high resolution millisecond timestamp marking the starting time of the Performance Entry.
-		 */
-		readonly startTime: number;
-
-		/**
-		 * The type of the performance entry.
-		 * Currently it may be one of: 'node', 'mark', 'measure', 'gc', or 'function'.
-		 */
-		readonly entryType: string;
-
-		/**
-		 * When performanceEntry.entryType is equal to 'gc', the performance.kind property identifies
-		 * the type of garbage collection operation that occurred.
-		 * The value may be one of perf_hooks.constants.
-		 */
-		readonly kind?: number;
-	}
-
-	export interface PerformanceNodeTiming extends PerformanceEntry {
-		/**
-		 * The high resolution millisecond timestamp at which the Node.js process completed bootstrap.
-		 */
-		readonly bootstrapComplete: number;
-
-		/**
-		 * The high resolution millisecond timestamp at which cluster processing ended.
-		 */
-		readonly clusterSetupEnd: number;
-
-		/**
-		 * The high resolution millisecond timestamp at which cluster processing started.
-		 */
-		readonly clusterSetupStart: number;
-
-		/**
-		 * The high resolution millisecond timestamp at which the Node.js event loop exited.
-		 */
-		readonly loopExit: number;
-
-		/**
-		 * The high resolution millisecond timestamp at which the Node.js event loop started.
-		 */
-		readonly loopStart: number;
-
-		/**
-		 * The high resolution millisecond timestamp at which main module load ended.
-		 */
-		readonly moduleLoadEnd: number;
-
-		/**
-		 * The high resolution millisecond timestamp at which main module load started.
-		 */
-		readonly moduleLoadStart: number;
-
-		/**
-		 * The high resolution millisecond timestamp at which the Node.js process was initialized.
-		 */
-		readonly nodeStart: number;
-
-		/**
-		 * The high resolution millisecond timestamp at which preload module load ended.
-		 */
-		readonly preloadModuleLoadEnd: number;
-
-		/**
-		 * The high resolution millisecond timestamp at which preload module load started.
-		 */
-		readonly preloadModuleLoadStart: number;
-
-		/**
-		 * The high resolution millisecond timestamp at which third_party_main processing ended.
-		 */
-		readonly thirdPartyMainEnd: number;
-
-		/**
-		 * The high resolution millisecond timestamp at which third_party_main processing started.
-		 */
-		readonly thirdPartyMainStart: number;
-
-		/**
-		 * The high resolution millisecond timestamp at which the V8 platform was initialized.
-		 */
-		readonly v8Start: number;
-    }
-
-	export interface Performance {
-		/**
-		 * If name is not provided, removes all PerformanceFunction objects from the Performance Timeline.
-		 * If name is provided, removes entries with name.
-		 * @param name
-		 */
-		clearFunctions(name?: string): void;
-
-		/**
-		 * If name is not provided, removes all PerformanceMark objects from the Performance Timeline.
-		 * If name is provided, removes only the named mark.
-		 * @param name
-		 */
-		clearMarks(name?: string): void;
-
-		/**
-		 * If name is not provided, removes all PerformanceMeasure objects from the Performance Timeline.
-		 * If name is provided, removes only objects whose performanceEntry.name matches name.
-		 */
-		clearMeasures(name?: string): void;
-
-		/**
-		 * Returns a list of all PerformanceEntry objects in chronological order with respect to performanceEntry.startTime.
-		 * @return list of all PerformanceEntry objects
-		 */
-		getEntries(): PerformanceEntry[];
-
-		/**
-		 * Returns a list of all PerformanceEntry objects in chronological order with respect to performanceEntry.startTime
-		 * whose performanceEntry.name is equal to name, and optionally, whose performanceEntry.entryType is equal to type.
-		 * @param name
-		 * @param type
-		 * @return list of all PerformanceEntry objects
-		 */
-		getEntriesByName(name: string, type?: string): PerformanceEntry[];
-
-		/**
-		 * Returns a list of all PerformanceEntry objects in chronological order with respect to performanceEntry.startTime
-		 * whose performanceEntry.entryType is equal to type.
-		 * @param type
-		 * @return list of all PerformanceEntry objects
-		 */
-		getEntriesByType(type: string): PerformanceEntry[];
-
-		/**
-		 * Creates a new PerformanceMark entry in the Performance Timeline.
-		 * A PerformanceMark is a subclass of PerformanceEntry whose performanceEntry.entryType is always 'mark',
-		 * and whose performanceEntry.duration is always 0.
-		 * Performance marks are used to mark specific significant moments in the Performance Timeline.
-		 * @param name
-		 */
-		mark(name?: string): void;
-
-		/**
-		 * Creates a new PerformanceMeasure entry in the Performance Timeline.
-		 * A PerformanceMeasure is a subclass of PerformanceEntry whose performanceEntry.entryType is always 'measure',
-		 * and whose performanceEntry.duration measures the number of milliseconds elapsed since startMark and endMark.
-		 *
-		 * The startMark argument may identify any existing PerformanceMark in the the Performance Timeline, or may identify
-		 * any of the timestamp properties provided by the PerformanceNodeTiming class. If the named startMark does not exist,
-		 * then startMark is set to timeOrigin by default.
-		 *
-		 * The endMark argument must identify any existing PerformanceMark in the the Performance Timeline or any of the timestamp
-		 * properties provided by the PerformanceNodeTiming class. If the named endMark does not exist, an error will be thrown.
-		 * @param name
-		 * @param startMark
-		 * @param endMark
-		 */
-		measure(name: string, startMark: string, endMark: string): void;
-
-		/**
-		 * An instance of the PerformanceNodeTiming class that provides performance metrics for specific Node.js operational milestones.
-		 */
-		readonly nodeTiming: PerformanceNodeTiming;
-
-		/**
-		 * @return the current high resolution millisecond timestamp
-		 */
-		now(): number;
-
-		/**
-		 * The timeOrigin specifies the high resolution millisecond timestamp from which all performance metric durations are measured.
-		 */
-		readonly timeOrigin: number;
-
-		/**
-		 * Wraps a function within a new function that measures the running time of the wrapped function.
-		 * A PerformanceObserver must be subscribed to the 'function' event type in order for the timing details to be accessed.
-		 * @param fn
-		 */
-		timerify<T extends (...optionalParams: any[]) => any>(fn: T): T;
+    export interface PerformanceEntry {
+        /**
+         * The total number of milliseconds elapsed for this entry.
+         * This value will not be meaningful for all Performance Entry types.
+         */
+        readonly duration: number;
+
+        /**
+         * The name of the performance entry.
+         */
+        readonly name: string;
+
+        /**
+         * The high resolution millisecond timestamp marking the starting time of the Performance Entry.
+         */
+        readonly startTime: number;
+
+        /**
+         * The type of the performance entry.
+         * Currently it may be one of: 'node', 'mark', 'measure', 'gc', or 'function'.
+         */
+        readonly entryType: string;
+
+        /**
+         * When performanceEntry.entryType is equal to 'gc', the performance.kind property identifies
+         * the type of garbage collection operation that occurred.
+         * The value may be one of perf_hooks.constants.
+         */
+        readonly kind?: number;
+    }
+
+    export interface PerformanceNodeTiming extends PerformanceEntry {
+        /**
+         * The high resolution millisecond timestamp at which the Node.js process completed bootstrap.
+         */
+        readonly bootstrapComplete: number;
+
+        /**
+         * The high resolution millisecond timestamp at which cluster processing ended.
+         */
+        readonly clusterSetupEnd: number;
+
+        /**
+         * The high resolution millisecond timestamp at which cluster processing started.
+         */
+        readonly clusterSetupStart: number;
+
+        /**
+         * The high resolution millisecond timestamp at which the Node.js event loop exited.
+         */
+        readonly loopExit: number;
+
+        /**
+         * The high resolution millisecond timestamp at which the Node.js event loop started.
+         */
+        readonly loopStart: number;
+
+        /**
+         * The high resolution millisecond timestamp at which main module load ended.
+         */
+        readonly moduleLoadEnd: number;
+
+        /**
+         * The high resolution millisecond timestamp at which main module load started.
+         */
+        readonly moduleLoadStart: number;
+
+        /**
+         * The high resolution millisecond timestamp at which the Node.js process was initialized.
+         */
+        readonly nodeStart: number;
+
+        /**
+         * The high resolution millisecond timestamp at which preload module load ended.
+         */
+        readonly preloadModuleLoadEnd: number;
+
+        /**
+         * The high resolution millisecond timestamp at which preload module load started.
+         */
+        readonly preloadModuleLoadStart: number;
+
+        /**
+         * The high resolution millisecond timestamp at which third_party_main processing ended.
+         */
+        readonly thirdPartyMainEnd: number;
+
+        /**
+         * The high resolution millisecond timestamp at which third_party_main processing started.
+         */
+        readonly thirdPartyMainStart: number;
+
+        /**
+         * The high resolution millisecond timestamp at which the V8 platform was initialized.
+         */
+        readonly v8Start: number;
+    }
+
+    export interface Performance {
+        /**
+         * If name is not provided, removes all PerformanceFunction objects from the Performance Timeline.
+         * If name is provided, removes entries with name.
+         * @param name
+         */
+        clearFunctions(name?: string): void;
+
+        /**
+         * If name is not provided, removes all PerformanceMark objects from the Performance Timeline.
+         * If name is provided, removes only the named mark.
+         * @param name
+         */
+        clearMarks(name?: string): void;
+
+        /**
+         * If name is not provided, removes all PerformanceMeasure objects from the Performance Timeline.
+         * If name is provided, removes only objects whose performanceEntry.name matches name.
+         */
+        clearMeasures(name?: string): void;
+
+        /**
+         * Returns a list of all PerformanceEntry objects in chronological order with respect to performanceEntry.startTime.
+         * @return list of all PerformanceEntry objects
+         */
+        getEntries(): PerformanceEntry[];
+
+        /**
+         * Returns a list of all PerformanceEntry objects in chronological order with respect to performanceEntry.startTime
+         * whose performanceEntry.name is equal to name, and optionally, whose performanceEntry.entryType is equal to type.
+         * @param name
+         * @param type
+         * @return list of all PerformanceEntry objects
+         */
+        getEntriesByName(name: string, type?: string): PerformanceEntry[];
+
+        /**
+         * Returns a list of all PerformanceEntry objects in chronological order with respect to performanceEntry.startTime
+         * whose performanceEntry.entryType is equal to type.
+         * @param type
+         * @return list of all PerformanceEntry objects
+         */
+        getEntriesByType(type: string): PerformanceEntry[];
+
+        /**
+         * Creates a new PerformanceMark entry in the Performance Timeline.
+         * A PerformanceMark is a subclass of PerformanceEntry whose performanceEntry.entryType is always 'mark',
+         * and whose performanceEntry.duration is always 0.
+         * Performance marks are used to mark specific significant moments in the Performance Timeline.
+         * @param name
+         */
+        mark(name?: string): void;
+
+        /**
+         * Creates a new PerformanceMeasure entry in the Performance Timeline.
+         * A PerformanceMeasure is a subclass of PerformanceEntry whose performanceEntry.entryType is always 'measure',
+         * and whose performanceEntry.duration measures the number of milliseconds elapsed since startMark and endMark.
+         *
+         * The startMark argument may identify any existing PerformanceMark in the the Performance Timeline, or may identify
+         * any of the timestamp properties provided by the PerformanceNodeTiming class. If the named startMark does not exist,
+         * then startMark is set to timeOrigin by default.
+         *
+         * The endMark argument must identify any existing PerformanceMark in the the Performance Timeline or any of the timestamp
+         * properties provided by the PerformanceNodeTiming class. If the named endMark does not exist, an error will be thrown.
+         * @param name
+         * @param startMark
+         * @param endMark
+         */
+        measure(name: string, startMark: string, endMark: string): void;
+
+        /**
+         * An instance of the PerformanceNodeTiming class that provides performance metrics for specific Node.js operational milestones.
+         */
+        readonly nodeTiming: PerformanceNodeTiming;
+
+        /**
+         * @return the current high resolution millisecond timestamp
+         */
+        now(): number;
+
+        /**
+         * The timeOrigin specifies the high resolution millisecond timestamp from which all performance metric durations are measured.
+         */
+        readonly timeOrigin: number;
+
+        /**
+         * Wraps a function within a new function that measures the running time of the wrapped function.
+         * A PerformanceObserver must be subscribed to the 'function' event type in order for the timing details to be accessed.
+         * @param fn
+         */
+        timerify<T extends (...optionalParams: any[]) => any>(fn: T): T;
     }
 
     export interface PerformanceObserverEntryList {
@@ -7156,5 +7157,5 @@ declare module "perf_hooks" {
         export const NODE_PERFORMANCE_GC_WEAKCB: number;
     }
 
-	const performance: Performance;
+    const performance: Performance;
 }

node v8/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/node",
-    "version": "8.5.8",
+    "version": "8.5.9",
     "description": "TypeScript definitions for Node.js",
     "license": "MIT",
     "contributors": [
@@ -95,6 +95,6 @@
     },
     "scripts": {},
     "dependencies": {},
-    "typesPublisherContentHash": "b30869fee6aefe6c92a5bc1f2de2aeab6516c4d53c3fc14ffaeb6a4fcbd3f47d",
+    "typesPublisherContentHash": "6609190e866fb6835d0ff0ca871ebad022c9b8dfe3bccc8bccd1fca32ae7ab7e",
     "typeScriptVersion": "2.0"
 }