Method parse

lib/jsdoc/src/parser.js:165–214

* Parse the given source files for JSDoc comments. * @param {Array. } sourceFiles An array of filepaths to the JavaScript sources. * @param {string} [encoding] * * @fires module:jsdoc/src/parser.Parser.parseBegin * @fires module:jsdoc/src/parser.Parser.fileBegin

(sourceFiles, encoding)

     * var docs = jsdocParser.parse(myFiles);
     */
    parse(sourceFiles, encoding) {
        encoding = encoding || jsdoc.env.conf.encoding || 'utf8';

        let filename = '';
        let sourceCode = '';
        let sourceFile;
        const parsedFiles = [];
        const e = {};

        if (typeof sourceFiles === 'string') {
            sourceFiles = [sourceFiles];
        }

        e.sourcefiles = sourceFiles;
        logger.debug('Parsing source files: %j', sourceFiles);

        this.emit('parseBegin', e);

        for (let i = 0, l = sourceFiles.length; i < l; i++) {
            sourceCode = '';
            sourceFile = sourceFiles[i];

            if (sourceFile.indexOf(SCHEMA) === 0) {
                sourceCode = sourceFile.substr(SCHEMA.length);
                filename = `[[string${i}]]`;
            }
            else {
                filename = sourceFile;
                try {
                    sourceCode = fs.readFileSync(filename, encoding);
                }
                catch (err) {
                    logger.error('Unable to read and parse the source file %s: %s', filename, err);
                }
            }

            if (sourceCode.length) {
                this._parseSourceCode(sourceCode, filename);
                parsedFiles.push(filename);
            }
        }

        this.emit('parseComplete', {
            sourcefiles: parsedFiles,
            doclets: this._resultBuffer
        });
        logger.debug('Finished parsing source files.');

        return this._resultBuffer;
    }

    // TODO: docs
    fireProcessingComplete(doclets) {