/** * Copyright 2017 Google Inc. All rights reserved. * Modifications copyright (c) Microsoft Corporation. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ import { EventEmitter } from 'events'; import * as types from './types'; import { Progress } from './progress'; import { debugLogger } from '../utils/debugLogger'; import { eventsHelper, RegisteredListener } from '../utils/eventsHelper'; class Helper { static completeUserURL(urlString: string): string { if (urlString.startsWith('localhost') || urlString.startsWith('127.0.0.1')) urlString = 'http://' + urlString; return urlString; } static enclosingIntRect(rect: types.Rect): types.Rect { const x = Math.floor(rect.x + 1e-3); const y = Math.floor(rect.y + 1e-3); const x2 = Math.ceil(rect.x + rect.width - 1e-3); const y2 = Math.ceil(rect.y + rect.height - 1e-3); return { x, y, width: x2 - x, height: y2 - y }; } static enclosingIntSize(size: types.Size): types.Size { return { width: Math.floor(size.width + 1e-3), height: Math.floor(size.height + 1e-3) }; } static getViewportSizeFromWindowFeatures(features: string[]): types.Size | null { const widthString = features.find(f => f.startsWith('width=')); const heightString = features.find(f => f.startsWith('height=')); const width = widthString ? parseInt(widthString.substring(6), 10) : NaN; const height = heightString ? parseInt(heightString.substring(7), 10) : NaN; if (!Number.isNaN(width) && !Number.isNaN(height)) return { width, height }; return null; } static waitForEvent(progress: Progress | null, emitter: EventEmitter, event: string | symbol, predicate?: Function): { promise: Promise, dispose: () => void } { const listeners: RegisteredListener[] = []; const promise = new Promise((resolve, reject) => { listeners.push(eventsHelper.addEventListener(emitter, event, eventArg => { try { if (predicate && !predicate(eventArg)) return; eventsHelper.removeEventListeners(listeners); resolve(eventArg); } catch (e) { eventsHelper.removeEventListeners(listeners); reject(e); } })); }); const dispose = () => eventsHelper.removeEventListeners(listeners); if (progress) progress.cleanupWhenAborted(dispose); return { promise, dispose }; } static secondsToRoundishMillis(value: number): number { return ((value * 1000000) | 0) / 1000; } static millisToRoundishMillis(value: number): number { return ((value * 1000) | 0) / 1000; } static debugProtocolLogger(protocolLogger?: types.ProtocolLogger): types.ProtocolLogger { return (direction: 'send' | 'receive', message: object) => { if (protocolLogger) protocolLogger(direction, message); if (debugLogger.isEnabled('protocol')) debugLogger.log('protocol', (direction === 'send' ? 'SEND ► ' : '◀ RECV ') + JSON.stringify(message)); }; } static formatBrowserLogs(logs: string[]) { if (!logs.length) return ''; return '\n' + '='.repeat(20) + ' Browser output: ' + '='.repeat(20) + '\n' + logs.join('\n'); } } export const helper = Helper;