> ## Documentation Index
> Fetch the complete documentation index at: https://omss.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# OMSSSourceGatheringError

> Returned when something/several things fail during source gathering.

```ts
return ERR(OMSSSourceGatheringError('Failed to gather sources', { cause: providerResults }))
```

```typescript
class OMSSSourceGatheringError extends OMSSError
```

## Constructor

```typescript
OMSSSourceGatheringError(message: string, options?: { cause: unknown }): OMSSSourceGatheringError
```

Create a new OMSSError.

### Parameters

<ResponseField name={"message"} type={"string"} required>
  Error message
</ResponseField>

<ResponseField name={"options"} type={"{ cause: unknown }"}>
  Additional options for the error
</ResponseField>

### Returns

`OMSSSourceGatheringError`

## Properties

<ResponseField name={"cause"} type={"unknown"} />

<ResponseField name={"message"} type={"string"} required />

<ResponseField name={"name"} type={"string"} required />

<ResponseField name={"stack"} type={"string"} />

<ResponseField name={"stackTraceLimit"} type={"number"} required>
  The `Error.stackTraceLimit` property specifies the number of stack frames
  collected by a stack trace (whether generated by `new Error().stack` or
  `Error.captureStackTrace(obj)`).

  The default value is `10` but may be set to any valid JavaScript number. Changes
  will affect any stack trace captured *after* the value has been changed.

  If set to a non-number value, or set to a negative number, stack traces will
  not capture any frames.
</ResponseField>

## Methods

### captureStackTrace()

```typescript
captureStackTrace(targetObject: object, constructorOpt?: Function): void
```

Creates a `.stack` property on `targetObject`, which when accessed returns
a string representing the location in the code at which
`Error.captureStackTrace()` was called.

```js
const myObject = {};
Error.captureStackTrace(myObject);
myObject.stack;  // Similar to `new Error().stack`
```

The first line of the trace will be prefixed with
`${myObject.name}: ${myObject.message}`.

The optional `constructorOpt` argument accepts a function. If given, all frames
above `constructorOpt`, including `constructorOpt`, will be omitted from the
generated stack trace.

The `constructorOpt` argument is useful for hiding implementation
details of error generation from the user. For instance:

```js
function a() {
  b();
}

function b() {
  c();
}

function c() {
  // Create an error without stack trace to avoid calculating the stack trace twice.
  const { stackTraceLimit } = Error;
  Error.stackTraceLimit = 0;
  const error = new Error();
  Error.stackTraceLimit = stackTraceLimit;

  // Capture the stack trace above function b
  Error.captureStackTrace(error, b); // Neither function c, nor b is included in the stack trace
  throw error;
}

a();
```

#### Parameters

<ResponseField name={"targetObject"} type={"object"} required />

<ResponseField name={"constructorOpt"} type={"Function"} />

### prepareStackTrace()

```typescript
prepareStackTrace(err: Error, stackTraces: CallSite[]): any
```

#### Parameters

<ResponseField name={"err"} type={"Error"} required />

<ResponseField name={"stackTraces"} type={"CallSite[]"} required />

#### Returns

`any`


## Related topics

- [Movie sources](/api-reference/movies/movie-sources.md)
- [Streaming sources for a movie](/spec/latest/ref/movies/movie-sources.md)
- [Refresh cached sources](/api-reference/refresh/refresh-cached-sources.md)