mirror of
https://github.com/angular/angular-cli.git
synced 2025-05-18 11:44:05 +08:00
b3d7080147
The `esModuleInterop` option is recommended to be enable by TypeScript and corrects several assumptions TypeScript would otherwise make when importing CommonJS files. This option change helps ensure compatibility as packages move towards ESM. Reference: https://www.typescriptlang.org/tsconfig#esModuleInterop
57 lines
1.8 KiB
TypeScript
57 lines
1.8 KiB
TypeScript
/**
|
|
* @license
|
|
* Copyright Google LLC All Rights Reserved.
|
|
*
|
|
* Use of this source code is governed by an MIT-style license that can be
|
|
* found in the LICENSE file at https://angular.io/license
|
|
*/
|
|
|
|
import open from 'open';
|
|
import { Command } from '../models/command';
|
|
import { Arguments } from '../models/interface';
|
|
import { Schema as DocCommandSchema } from './doc';
|
|
|
|
export class DocCommand extends Command<DocCommandSchema> {
|
|
public async run(options: DocCommandSchema & Arguments) {
|
|
if (!options.keyword) {
|
|
this.logger.error('You should specify a keyword, for instance, `ng doc ActivatedRoute`.');
|
|
|
|
return 0;
|
|
}
|
|
|
|
let domain = 'angular.io';
|
|
|
|
if (options.version) {
|
|
// version can either be a string containing "next"
|
|
if (options.version == 'next') {
|
|
domain = 'next.angular.io';
|
|
// or a number where version must be a valid Angular version (i.e. not 0, 1 or 3)
|
|
} else if (!isNaN(+options.version) && ![0, 1, 3].includes(+options.version)) {
|
|
domain = `v${options.version}.angular.io`;
|
|
} else {
|
|
this.logger.error('Version should either be a number (2, 4, 5, 6...) or "next"');
|
|
|
|
return 0;
|
|
}
|
|
} else {
|
|
// we try to get the current Angular version of the project
|
|
// and use it if we can find it
|
|
try {
|
|
/* eslint-disable-next-line import/no-extraneous-dependencies */
|
|
const currentNgVersion = (await import('@angular/core')).VERSION.major;
|
|
domain = `v${currentNgVersion}.angular.io`;
|
|
} catch (e) {}
|
|
}
|
|
|
|
let searchUrl = `https://${domain}/api?query=${options.keyword}`;
|
|
|
|
if (options.search) {
|
|
searchUrl = `https://${domain}/docs?search=${options.keyword}`;
|
|
}
|
|
|
|
await open(searchUrl, {
|
|
wait: false,
|
|
});
|
|
}
|
|
}
|