@theia/core
Version:
Theia is a cloud & desktop IDE framework implemented in TypeScript.
96 lines (82 loc) • 2.94 kB
text/typescript
// *****************************************************************************
// Copyright (C) 2017 TypeFox and others.
//
// This program and the accompanying materials are made available under the
// terms of the Eclipse Public License v. 2.0 which is available at
// http://www.eclipse.org/legal/epl-2.0.
//
// This Source Code may also be made available under the following Secondary
// Licenses when the conditions for such availability set forth in the Eclipse
// Public License v. 2.0 are satisfied: GNU General Public License, version 2
// with the GNU Classpath Exception which is available at
// https://www.gnu.org/software/classpath/license.html.
//
// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
// *****************************************************************************
function is(userAgent: string, platform: string): boolean {
if (typeof navigator !== 'undefined') {
if (navigator.userAgent && navigator.userAgent.indexOf(userAgent) >= 0) {
return true;
}
}
if (typeof process !== 'undefined') {
return (process.platform === platform);
}
return false;
}
// `let` so that tests can override them with `OS.override`, as the exports of ES modules cannot be stubbed.
export let isWindows = is('Windows', 'win32');
export let isOSX = is('Mac', 'darwin');
export const EOL = isWindows ? '\r\n' : '\n';
export type CMD = [string, string[]];
export function cmd(command: string, ...args: string[]): CMD {
return [
isWindows ? 'cmd' : command,
isWindows ? ['/c', command, ...args] : args
];
}
export namespace OS {
/**
* Enumeration of the supported operating systems.
*/
export enum Type {
Windows = 'Windows',
Linux = 'Linux',
OSX = 'OSX'
}
/**
* Returns with the type of the operating system. If it is neither [Windows](isWindows) nor [OS X](isOSX), then
* it always return with the `Linux` OS type.
*/
export function type(): OS.Type {
if (isWindows) {
return Type.Windows;
}
if (isOSX) {
return Type.OSX;
}
return Type.Linux;
}
export const backend = {
type,
isWindows,
isOSX,
EOL
};
/**
* Overrides the detected value of `isWindows` or `isOSX`, e.g. to test platform specific behavior.
* The exports of ES modules cannot be replaced by test doubles, so tests use this function instead.
*/
export function override(property: 'isWindows' | 'isOSX', value: boolean): void {
if (property === 'isWindows') {
isWindows = value;
} else {
isOSX = value;
}
}
}
export const OSBackendProviderPath = '/os';
export const OSBackendProvider = Symbol('OSBackendProvider');
export interface OSBackendProvider {
getBackendOS(): Promise<OS.Type>;
}