Skip to content

Commit a5bf4f6

Browse files
committed
1 parent 5cd3457 commit a5bf4f6

File tree

1 file changed

+28
-10
lines changed

1 file changed

+28
-10
lines changed

packages/core/src/types-hoist/options.ts

Lines changed: 28 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -13,20 +13,25 @@ import type { BaseTransportOptions, Transport } from './transport';
1313
export interface ClientOptions<TO extends BaseTransportOptions = BaseTransportOptions> {
1414
/**
1515
* Enable debug functionality in the SDK itself
16+
* @default false
1617
*/
1718
debug?: boolean;
1819

1920
/**
2021
* Specifies whether this SDK should send events to Sentry.
21-
* Defaults to true.
22+
* @default true
2223
*/
2324
enabled?: boolean;
2425

25-
/** Attaches stacktraces to pure capture message / log integrations */
26+
/**
27+
* Attaches stacktraces to pure capture message / log integrations
28+
* @default false
29+
*/
2630
attachStacktrace?: boolean;
2731

2832
/**
2933
* Send SDK Client Reports. When calling `Sentry.init()`, this option defaults to `true`.
34+
* @default true
3035
*/
3136
sendClientReports?: boolean;
3237

@@ -43,14 +48,18 @@ export interface ClientOptions<TO extends BaseTransportOptions = BaseTransportOp
4348
*/
4449
release?: string;
4550

46-
/** The current environment of your application (e.g. "production"). */
51+
/**
52+
* The current environment of your application (e.g. "production").
53+
* @default "production"
54+
*/
4755
environment?: string;
4856

4957
/** Sets the distribution for all events */
5058
dist?: string;
5159

5260
/**
5361
* List of integrations that should be installed after SDK was initialized.
62+
* @default []
5463
*/
5564
integrations: Integration[];
5665

@@ -101,8 +110,9 @@ export interface ClientOptions<TO extends BaseTransportOptions = BaseTransportOp
101110
initialScope?: CaptureContext;
102111

103112
/**
104-
* The maximum number of breadcrumbs sent with events. Defaults to 100.
113+
* The maximum number of breadcrumbs sent with events.
105114
* Sentry has a maximum payload size of 1MB and any events exceeding that payload size will be dropped.
115+
* @default 100
106116
*/
107117
maxBreadcrumbs?: number;
108118

@@ -111,10 +121,14 @@ export interface ClientOptions<TO extends BaseTransportOptions = BaseTransportOp
111121
*
112122
* 0.0 = 0% chance of a given event being sent (send no events) 1.0 = 100% chance of a given event being sent (send
113123
* all events)
124+
* @default 1.0
114125
*/
115126
sampleRate?: number;
116127

117-
/** Maximum number of chars a single value can have before it will be truncated. */
128+
/**
129+
* Maximum number of chars a single value can have before it will be truncated.
130+
* @default 250
131+
*/
118132
maxValueLength?: number;
119133

120134
/**
@@ -124,7 +138,7 @@ export interface ClientOptions<TO extends BaseTransportOptions = BaseTransportOp
124138
* - `user`
125139
* - `contexts`
126140
* - `extra`
127-
* Defaults to `3`. Set to `0` to disable.
141+
* @default 3
128142
*/
129143
normalizeDepth?: number;
130144

@@ -135,19 +149,21 @@ export interface ClientOptions<TO extends BaseTransportOptions = BaseTransportOp
135149
* - `user`
136150
* - `contexts`
137151
* - `extra`
138-
* Defaults to `1000`
152+
* @default 1000
139153
*/
140154
normalizeMaxBreadth?: number;
141155

142156
/**
143157
* A pattern for error messages which should not be sent to Sentry.
144158
* By default, all errors will be sent.
159+
* @default []
145160
*/
146161
ignoreErrors?: Array<string | RegExp>;
147162

148163
/**
149164
* A pattern for transaction names which should not be sent to Sentry.
150165
* By default, all transactions will be sent.
166+
* @default []
151167
*/
152168
ignoreTransactions?: Array<string | RegExp>;
153169

@@ -162,8 +178,7 @@ export interface ClientOptions<TO extends BaseTransportOptions = BaseTransportOp
162178
* Controls if potentially sensitive data should be sent to Sentry by default.
163179
* Note that this only applies to data that the SDK is sending by default
164180
* but not data that was explicitly set (e.g. by calling `Sentry.setUser()`).
165-
*
166-
* Defaults to `false`.
181+
* @default false
167182
*
168183
* NOTE: This option currently controls only a few data points in a selected
169184
* set of SDKs. The goal for this option is to eventually control all sensitive
@@ -186,7 +201,8 @@ export interface ClientOptions<TO extends BaseTransportOptions = BaseTransportOp
186201
// eslint-disable-next-line @typescript-eslint/no-explicit-any
187202
[key: string]: any;
188203
/**
189-
* If logs support should be enabled. Defaults to false.
204+
* If logs support should be enabled.
205+
* @default false
190206
*/
191207
enableLogs?: boolean;
192208
/**
@@ -208,6 +224,7 @@ export interface ClientOptions<TO extends BaseTransportOptions = BaseTransportOp
208224
* By default, all errors will be sent.
209225
*
210226
* Requires the use of the `InboundFilters` integration.
227+
* @default []
211228
*/
212229
allowUrls?: Array<string | RegExp>;
213230

@@ -217,6 +234,7 @@ export interface ClientOptions<TO extends BaseTransportOptions = BaseTransportOp
217234
* By default, all errors will be sent.
218235
*
219236
* Requires the use of the `InboundFilters` integration.
237+
* @default []
220238
*/
221239
denyUrls?: Array<string | RegExp>;
222240

0 commit comments

Comments
 (0)