browser.d.ts

export=browser
declare namespace browser
{
	/**
	 * Currently only WebKit-based Web Inspectors, Firefox >= v31,
	 * and the Firebug extension (any Firefox version) are known
	 * to support "%c" CSS customizations.
	 *
	 * TODO: add a `localStorage` variable to explicitly enable/disable colors
	 */
	 function useColors(): boolean;

	/**
	 * Colorize log arguments if enabled.
	 *
	 * @api public
	 */
	 function formatArgs(args: string[]): void;

	/**
	 * Save `namespaces`.
	 *
	 * @param {String} namespaces
	 * @api private
	 */
	 function save(namespaces: string): void;

	/**
	 * Load `namespaces`.
	 *
	 * @return {String} returns the previously persisted debug modes
	 * @api private
	 */
	 function load(): string;

	/**
	 * Localstorage attempts to return the localstorage.
	 *
	 * This is necessary because safari throws
	 * when a user disables cookies/localstorage
	 * and you attempt to access it.
	 *
	 * @return {LocalStorage}
	 * @api private
	 */
	 function localstorage(): Storage;

	 const formatters: { j: (str:string) => string };
}