ee135b20a9
<!-- Please make sure you have read the submission guidelines before posting an PR --> <!-- https://github.com/nrwl/nx/blob/master/CONTRIBUTING.md#-submitting-a-pr --> <!-- Please make sure that your commit message follows our format --> <!-- Example: `fix(nx): must begin with lowercase` --> <!-- If this is a particularly complex change or feature addition, you can request a dedicated Nx release for this pull request branch. Mention someone from the Nx team or the `@nrwl/nx-pipelines-reviewers` and they will confirm if the PR warrants its own release for testing purposes, and generate it for you if appropriate. --> ## Current Behavior <!-- This is the behavior we have today --> ## Expected Behavior <!-- This is the behavior we should expect with the changes in this PR --> <img width="1025" alt="Screenshot 2024-12-21 at 9 51 18 PM" src="https://github.com/user-attachments/assets/32815566-c532-4186-bc94-4b017b0a84c2" /> ## Related Issue(s) <!-- Please link the issue being fixed so it gets closed when this is merged. --> Fixes #
205 lines
5.3 KiB
Markdown
205 lines
5.3 KiB
Markdown
# Class: AggregateCreateNodesError
|
|
|
|
This error should be thrown when a `createNodesV2` function hits a recoverable error.
|
|
It allows Nx to recieve partial results and continue processing for better UX.
|
|
|
|
## Hierarchy
|
|
|
|
- `Error`
|
|
|
|
↳ **`AggregateCreateNodesError`**
|
|
|
|
## Table of contents
|
|
|
|
### Constructors
|
|
|
|
- [constructor](../../devkit/documents/AggregateCreateNodesError#constructor)
|
|
|
|
### Properties
|
|
|
|
- [cause](../../devkit/documents/AggregateCreateNodesError#cause): unknown
|
|
- [errors](../../devkit/documents/AggregateCreateNodesError#errors): [file: string, error: Error][]
|
|
- [message](../../devkit/documents/AggregateCreateNodesError#message): string
|
|
- [name](../../devkit/documents/AggregateCreateNodesError#name): string
|
|
- [partialResults](../../devkit/documents/AggregateCreateNodesError#partialresults): CreateNodesResultV2
|
|
- [pluginIndex](../../devkit/documents/AggregateCreateNodesError#pluginindex): number
|
|
- [stack](../../devkit/documents/AggregateCreateNodesError#stack): string
|
|
- [prepareStackTrace](../../devkit/documents/AggregateCreateNodesError#preparestacktrace): Function
|
|
- [stackTraceLimit](../../devkit/documents/AggregateCreateNodesError#stacktracelimit): number
|
|
|
|
### Methods
|
|
|
|
- [captureStackTrace](../../devkit/documents/AggregateCreateNodesError#capturestacktrace)
|
|
|
|
## Constructors
|
|
|
|
### constructor
|
|
|
|
• **new AggregateCreateNodesError**(`errors`, `partialResults`): [`AggregateCreateNodesError`](../../devkit/documents/AggregateCreateNodesError)
|
|
|
|
Throwing this error from a `createNodesV2` function will allow Nx to continue processing and recieve partial results from your plugin.
|
|
|
|
#### Parameters
|
|
|
|
| Name | Type | Description |
|
|
| :--------------- | :------------------------------------------------------------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
| `errors` | [file: string, error: Error][] | An array of tuples that represent errors encountered when processing a given file. An example entry might look like ['path/to/project.json', [Error: 'Invalid JSON. Unexpected token 'a' in JSON at position 0]] |
|
|
| `partialResults` | [`CreateNodesResultV2`](../../devkit/documents/CreateNodesResultV2) | The partial results of the `createNodesV2` function. This should be the results for each file that didn't encounter an issue. |
|
|
|
|
#### Returns
|
|
|
|
[`AggregateCreateNodesError`](../../devkit/documents/AggregateCreateNodesError)
|
|
|
|
**`Example`**
|
|
|
|
```ts
|
|
export async function createNodesV2(files: string[]) {
|
|
const partialResults = [];
|
|
const errors = [];
|
|
await Promise.all(
|
|
files.map(async (file) => {
|
|
try {
|
|
const result = await createNodes(file);
|
|
partialResults.push(result);
|
|
} catch (e) {
|
|
errors.push([file, e]);
|
|
}
|
|
})
|
|
);
|
|
if (errors.length > 0) {
|
|
throw new AggregateCreateNodesError(errors, partialResults);
|
|
}
|
|
return partialResults;
|
|
}
|
|
```
|
|
|
|
#### Overrides
|
|
|
|
Error.constructor
|
|
|
|
## Properties
|
|
|
|
### cause
|
|
|
|
• `Optional` **cause**: `unknown`
|
|
|
|
#### Inherited from
|
|
|
|
Error.cause
|
|
|
|
---
|
|
|
|
### errors
|
|
|
|
• `Readonly` **errors**: [file: string, error: Error][]
|
|
|
|
An array of tuples that represent errors encountered when processing a given file. An example entry might look like ['path/to/project.json', [Error: 'Invalid JSON. Unexpected token 'a' in JSON at position 0]]
|
|
|
|
---
|
|
|
|
### message
|
|
|
|
• **message**: `string`
|
|
|
|
#### Inherited from
|
|
|
|
Error.message
|
|
|
|
---
|
|
|
|
### name
|
|
|
|
• **name**: `string`
|
|
|
|
#### Inherited from
|
|
|
|
Error.name
|
|
|
|
---
|
|
|
|
### partialResults
|
|
|
|
• `Readonly` **partialResults**: [`CreateNodesResultV2`](../../devkit/documents/CreateNodesResultV2)
|
|
|
|
The partial results of the `createNodesV2` function. This should be the results for each file that didn't encounter an issue.
|
|
|
|
---
|
|
|
|
### pluginIndex
|
|
|
|
• **pluginIndex**: `number`
|
|
|
|
---
|
|
|
|
### stack
|
|
|
|
• `Optional` **stack**: `string`
|
|
|
|
#### Inherited from
|
|
|
|
Error.stack
|
|
|
|
---
|
|
|
|
### prepareStackTrace
|
|
|
|
▪ `Static` `Optional` **prepareStackTrace**: (`err`: `Error`, `stackTraces`: `CallSite`[]) => `any`
|
|
|
|
Optional override for formatting stack traces
|
|
|
|
**`See`**
|
|
|
|
https://v8.dev/docs/stack-trace-api#customizing-stack-traces
|
|
|
|
#### Type declaration
|
|
|
|
▸ (`err`, `stackTraces`): `any`
|
|
|
|
##### Parameters
|
|
|
|
| Name | Type |
|
|
| :------------ | :----------- |
|
|
| `err` | `Error` |
|
|
| `stackTraces` | `CallSite`[] |
|
|
|
|
##### Returns
|
|
|
|
`any`
|
|
|
|
#### Inherited from
|
|
|
|
Error.prepareStackTrace
|
|
|
|
---
|
|
|
|
### stackTraceLimit
|
|
|
|
▪ `Static` **stackTraceLimit**: `number`
|
|
|
|
#### Inherited from
|
|
|
|
Error.stackTraceLimit
|
|
|
|
## Methods
|
|
|
|
### captureStackTrace
|
|
|
|
▸ **captureStackTrace**(`targetObject`, `constructorOpt?`): `void`
|
|
|
|
Create .stack property on a target object
|
|
|
|
#### Parameters
|
|
|
|
| Name | Type |
|
|
| :---------------- | :--------- |
|
|
| `targetObject` | `object` |
|
|
| `constructorOpt?` | `Function` |
|
|
|
|
#### Returns
|
|
|
|
`void`
|
|
|
|
#### Inherited from
|
|
|
|
Error.captureStackTrace
|