Utilizzo di TypeScript

L'uso di TypeScript facilita lo sviluppo fornendo l'evidenziazione automatica di metodi e proprietà, oltre al controllo dei tipi:

Raccomandiamo di utilizzare l'editor Visual Studio Code per la creazione e la modifica degli scraper

Installa la libreria dei tipi di A-Parser:

cd files/
npm install a-parser-types

A-Parser crea automaticamente un file di configurazione base TypeScript se assente:

files/tsconfig.json

{
    "compilerOptions": {
        "target": "esnext",
        "moduleResolution": "node",
        "module": "commonjs",
        "sourceMap": true,
        "baseUrl": ".",
        "paths": {
            "*": ["node_modules/*", "../dist/nodejs/node_modules/*"]
        }
    },
    "include": ["**/*.ts"]
}

Crea il file dello scraper:

mkdir files/parsers/Awesome-Parser/
touch files/parsers/Awesome-Parser/Awesome-Parser.ts

Usa questo modello per iniziare lo sviluppo:

files/parsers/Awesome-Parser/Awesome-Parser.ts

import { BaseParser } from 'a-parser-types';

export class JS_Awesome_Parser extends BaseParser {
    static defaultConf: typeof BaseParser.defaultConf = {
        version: '0.0.1',
        results: {
            flat: [
                ['title', 'Title'],
            ],
            arrays: {
            }
        },
        results_format: "Title: $title\n",
    };

    static editableConf: typeof BaseParser.editableConf = [
    ];

    async parse(set, results) {
        ...

        return results;
    }
}

nota

A-Parser compilerà automaticamente i file .ts in .js prima di avviare lo scraper

Differenze rispetto all'API v1

• I generatori sono stati sostituiti da async/await
• I campi defaultConf e editableConf sono diventati static
• La classe dello scraper deve ereditare da BaseParser
• TypeScript può essere utilizzato opzionalmente, raccomandiamo di usarlo per impostazione predefinita per l'evidenziazione dei metodi e dei parametri disponibili