TypeDoc API - v0.28.2

    Interface OptionsReader

    Describes an option reader that discovers user configuration and converts it to the TypeDoc format.

    interface OptionsReader {
        name: string;
        order: number;
        supportsPackages: boolean;
        read(
            container: Configuration.Options,
            logger: Logger,
            cwd: string,
            usedFile: (file: string) => void,
        ): void | Promise<void>;
    }

    Implemented by

    Index

    Methods

    read

    Properties

    name order supportsPackages

    Methods

    • Read options from the reader's source and place them in the options parameter. Options without a declared name may be treated as if they were declared with type ParameterType.Mixed. Options which have been declared must be converted to the correct type. As an alternative to doing this conversion in the reader, the reader may use Options.setValue, which will correctly convert values.

      Parameters

      • container: Configuration.Options

        the options container that provides declarations

      • logger: Logger

        logger to be used to report errors

      • cwd: string

        the directory which should be treated as the current working directory for option file discovery

      • usedFile: (file: string) => void

        a callback to track files that were read or whose existence was checked, for purposes of restarting a build when watching files

      Returns void | Promise<void>

    Properties

    name: string

    The name of this reader so that it may be removed by plugins without the plugin accessing the instance performing the read. Multiple readers may have the same name.

    order: number

    Readers will be processed according to their orders. A higher order indicates that the reader should be called later.

    Note that to preserve expected behavior, the argv reader must have both the lowest order so that it may set the location of config files used by other readers and the highest order so that it can override settings from lower order readers.

    supportsPackages: boolean

    Flag to indicate that this reader should be included in sub-options objects created to read options for packages mode.

    Settings

    Member Visibility

    On This Page

    Methods
    Properties
    MMNEPVFCICPMFPCPTTAAATR