@angular-devkit/architect

constructor

constructor(
    _host: ArchitectHost<any>,
    registry?: json.schema.SchemaRegistry,
    additionalJobRegistry?: experimental.jobs.Registry
);

method has

has: (name: experimental.jobs.JobName) => Observable<boolean>;

method scheduleBuilder

scheduleBuilder: (
    name: string,
    options: json.JsonObject,
    scheduleOptions?: ScheduleOptions
) => Promise<BuilderRun>;

method scheduleTarget

scheduleTarget: (
    target: Target,
    overrides?: json.JsonObject,
    scheduleOptions?: ScheduleOptions
) => Promise<BuilderRun>;

property analytics

readonly analytics: analytics.Analytics;

• API to report analytics. This might be undefined if the feature is unsupported. This might not be undefined, but the backend could also not report anything.

property builder

builder: BuilderInfo;

• The builder info that called your function. Since the builder info is from the builder.json (or the host), it could contain information that is different than expected.

property currentDirectory

currentDirectory: string;

• The current directory the user is in. This could be outside the workspace root. This is a system path and will not be normalized; ie. on Windows it will starts with C:\\ (or whatever drive).

property id

id: number;

• Unique amongst contexts. Contexts instances are not guaranteed to be the same (but it could be the same context), and all the fields in a context could be the same, yet the builder's context could be different. This is the same ID as the corresponding run.

property logger

logger: logging.LoggerApi;

• A logger that appends messages to a log. This could be a separate interface or completely ignored. console.log could also be completely ignored.

property target

target?: Target;

• The target that was used to run this builder. Target is optional if a builder was ran using scheduleBuilder().

property workspaceRoot

workspaceRoot: string;

• The absolute workspace root of this run. This is a system path and will not be normalized; ie. on Windows it will starts with C:\\ (or whatever drive).

method addTeardown

addTeardown: (teardown: () => Promise<void> | void) => void;

• Add teardown logic to this Context, so that when it's being stopped it will execute teardown.

method getBuilderNameForTarget

getBuilderNameForTarget: (target: Target) => Promise<string>;

• Resolves and return a builder name. The exact format of the name is up to the host, so it should not be parsed to gather information (it's free form). This string can be used to validate options or schedule a builder directly.

  Parameter target

  The target to resolve the builder name.

method getProjectMetadata

getProjectMetadata: {
    (projectName: string): Promise<json.JsonObject>;
    (target: any): Promise<json.JsonObject>;
};

method getTargetOptions

getTargetOptions: (target: Target) => Promise<json.JsonObject>;

• Resolve and return options for a specified target. If the target isn't defined in the workspace this will reject the promise. This object will be read directly from the workspace but not validated against the builder of the target.

  Parameter target

  The target to resolve the options of. A non-validated object resolved from the workspace.

method reportProgress

reportProgress: (current: number, total?: number, status?: string) => void;

• Update the progress for this builder run.

  Parameter current

  The current progress. This will be between 0 and total.

  Parameter total

  A new total to set. By default at the start of a run this is 1. If omitted it will use the same value as the last total.

  Parameter status

  Update the status string. If omitted the status string is not modified.

method reportRunning

reportRunning: () => void;

• Set the builder to running. This should be used if an external event triggered a re-run, e.g. a file watched was changed.

method reportStatus

reportStatus: (status: string) => void;

• Update the status string shown on the interface.

  Parameter status

  The status to set it to. An empty string can be used to remove the status.

method scheduleBuilder

scheduleBuilder: (
    builderName: string,
    options?: json.JsonObject,
    scheduleOptions?: ScheduleOptions
) => Promise<BuilderRun>;

• Schedule a builder by its name. This can be the same builder that is being executed.

  Parameter builderName

  The name of the builder, ie. its packageName:builderName tuple.

  Parameter options

  All options to use for the builder (by default empty object). There is no additional options added, e.g. from the workspace.

  Parameter scheduleOptions

  Additional optional scheduling options. A promise of a run. It will resolve when all the members of the run are available.

method scheduleTarget

scheduleTarget: (
    target: Target,
    overrides?: json.JsonObject,
    scheduleOptions?: ScheduleOptions
) => Promise<BuilderRun>;

• Schedule a target in the same workspace. This can be the same target that is being executed right now, but targets of the same name are serialized. Running the same target and waiting for it to end will result in a deadlocking scenario. Targets are considered the same if the project, the target AND the configuration are the same.

  Parameter target

  The target to schedule.

  Parameter overrides

  A set of options to override the workspace set of options.

  Parameter scheduleOptions

  Additional optional scheduling options. A promise of a run. It will resolve when all the members of the run are available.

method validateOptions

validateOptions: <T extends json.JsonObject = json.JsonObject>(
    options: json.JsonObject,
    builderName: string
) => Promise<T>;

• Validates the options against a builder schema. This uses the same methods as the scheduleTarget and scheduleBrowser methods to validate and apply defaults to the options. It can be generically typed, if you know which interface it is supposed to validate against.

  Parameter options

  A generic option object to validate.

  Parameter builderName

  The name of a builder to use. This can be gotten for a target by using the getBuilderForTarget() method on the context.

call signature

(input: A, context: BuilderContext): BuilderOutputLike;

• Builders are defined by users to perform any kind of task, like building, testing or linting, and should use this interface.

  Parameter input

  The options (a JsonObject), validated by the schema and received by the builder. This can include resolved options from the CLI or the workspace.

  Parameter context

  A context that can be used to interact with the Architect framework. One or many builder output.

property id

id: number;

• Unique amongst runs. This is the same ID as the context generated for the run. It can be used to identify multiple unique runs. There is no guarantee that a run is a single output; a builder can rebuild on its own and will generate multiple outputs.

property info

info: BuilderInfo;

• The builder information.

property output

output: Observable<BuilderOutput>;

• The output(s) from the builder. A builder can have multiple outputs. This always replay the last output when subscribed.

property progress

progress: Observable<BuilderProgressReport>;

• The progress report. A progress also contains an ID, which can be different than this run's ID (if the builder calls scheduleBuilder or scheduleTarget). This will always replay the last progress on new subscriptions.

property result

result: Promise<BuilderOutput>;

• The next output from a builder. This is recommended when scheduling a builder and only being interested in the result of that single run, not of a watch-mode builder.

method stop

stop: () => Promise<void>;

• Stop the builder from running. Returns a promise that resolves when the builder is stopped. Some builders might not handle stopping properly and should have a timeout here.

property analytics

analytics?: analytics.Analytics;

property logger

logger?: logging.Logger;

member Error

Error = 'error'

member Running

Running = 'running'

member Stopped

Stopped = 'stopped'

member Waiting

Waiting = 'waiting'