bun-types 1.2.19-canary.20250713T140533 → 1.2.19-canary.20250714T140751

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -2,6 +2,25 @@
2
2
  **Note** — Bun provides a browser- and Node.js-compatible [console](https://developer.mozilla.org/en-US/docs/Web/API/console) global. This page only documents Bun-native APIs.
3
3
  {% /callout %}
4
4
 
5
+ ## Object inspection depth
6
+
7
+ Bun allows you to configure how deeply nested objects are displayed in `console.log()` output:
8
+
9
+ - **CLI flag**: Use `--console-depth <number>` to set the depth for a single run
10
+ - **Configuration**: Set `console.depth` in your `bunfig.toml` for persistent configuration
11
+ - **Default**: Objects are inspected to a depth of `2` levels
12
+
13
+ ```js
14
+ const nested = { a: { b: { c: { d: "deep" } } } };
15
+ console.log(nested);
16
+ // Default (depth 2): { a: { b: [Object] } }
17
+ // With depth 4: { a: { b: { c: { d: 'deep' } } } }
18
+ ```
19
+
20
+ The CLI flag takes precedence over the configuration file setting.
21
+
22
+ ## Reading from stdin
23
+
5
24
  In Bun, the `console` object can be used as an `AsyncIterable` to sequentially read lines from `process.stdin`.
6
25
 
7
26
  ```ts
package/docs/api/fetch.md CHANGED
@@ -337,7 +337,7 @@ This will print the request and response headers to your terminal:
337
337
  ```sh
338
338
  [fetch] > HTTP/1.1 GET http://example.com/
339
339
  [fetch] > Connection: keep-alive
340
- [fetch] > User-Agent: Bun/1.2.19-canary.20250713T140533
340
+ [fetch] > User-Agent: Bun/1.2.19-canary.20250714T140751
341
341
  [fetch] > Accept: */*
342
342
  [fetch] > Host: example.com
343
343
  [fetch] > Accept-Encoding: gzip, deflate, br
package/docs/api/spawn.md CHANGED
@@ -140,7 +140,7 @@ You can read results from the subprocess via the `stdout` and `stderr` propertie
140
140
  ```ts
141
141
  const proc = Bun.spawn(["bun", "--version"]);
142
142
  const text = await proc.stdout.text();
143
- console.log(text); // => "1.2.19-canary.20250713T140533\n"
143
+ console.log(text); // => "1.2.19-canary.20250714T140751\n"
144
144
  ```
145
145
 
146
146
  Configure the output stream by passing one of the following values to `stdout/stderr`:
package/docs/cli/pm.md CHANGED
@@ -158,7 +158,7 @@ To display current package version and help:
158
158
 
159
159
  ```bash
160
160
  $ bun pm version
161
- bun pm version v1.2.19-canary.20250713T140533 (ca7428e9)
161
+ bun pm version v1.2.19-canary.20250714T140751 (ca7428e9)
162
162
  Current package version: v1.0.0
163
163
 
164
164
  Increment:
@@ -7,7 +7,7 @@ Use `bun publish` to publish a package to the npm registry.
7
7
  $ bun publish
8
8
 
9
9
  ## Output
10
- bun publish v1.2.19-canary.20250713T140533 (ca7428e9)
10
+ bun publish v1.2.19-canary.20250714T140751 (ca7428e9)
11
11
 
12
12
  packed 203B package.json
13
13
  packed 224B README.md
package/docs/cli/run.md CHANGED
@@ -185,6 +185,23 @@ This is TypeScript!
185
185
 
186
186
  For convenience, all code is treated as TypeScript with JSX support when using `bun run -`.
187
187
 
188
+ ## `bun run --console-depth`
189
+
190
+ Control the depth of object inspection in console output with the `--console-depth` flag.
191
+
192
+ ```bash
193
+ $ bun --console-depth 5 run index.tsx
194
+ ```
195
+
196
+ This sets how deeply nested objects are displayed in `console.log()` output. The default depth is `2`. Higher values show more nested properties but may produce verbose output for complex objects.
197
+
198
+ ```js
199
+ const nested = { a: { b: { c: { d: "deep" } } } };
200
+ console.log(nested);
201
+ // With --console-depth 2 (default): { a: { b: [Object] } }
202
+ // With --console-depth 4: { a: { b: { c: { d: 'deep' } } } }
203
+ ```
204
+
188
205
  ## `bun run --smol`
189
206
 
190
207
  In memory-constrained environments, use the `--smol` flag to reduce memory usage at a cost to performance.
@@ -9,7 +9,7 @@ $ bunx nuxi init my-nuxt-app
9
9
  ✔ Which package manager would you like to use?
10
10
  bun
11
11
  ◐ Installing dependencies...
12
- bun install v1.2.19-canary.20250713T140533 (16b4bf34)
12
+ bun install v1.2.19-canary.20250714T140751 (16b4bf34)
13
13
  + @nuxt/devtools@0.8.2
14
14
  + nuxt@3.7.0
15
15
  785 packages installed [2.67s]
@@ -15,7 +15,7 @@ This will add the package to `peerDependencies` in `package.json`.
15
15
  ```json-diff
16
16
  {
17
17
  "peerDependencies": {
18
- + "@types/bun": "^1.2.19-canary.20250713T140533"
18
+ + "@types/bun": "^1.2.19-canary.20250714T140751"
19
19
  }
20
20
  }
21
21
  ```
@@ -27,7 +27,7 @@ Running `bun install` will install peer dependencies by default, unless marked o
27
27
  ```json-diff
28
28
  {
29
29
  "peerDependencies": {
30
- "@types/bun": "^1.2.19-canary.20250713T140533"
30
+ "@types/bun": "^1.2.19-canary.20250714T140751"
31
31
  },
32
32
  "peerDependenciesMeta": {
33
33
  + "@types/bun": {
@@ -97,7 +97,7 @@ $ bun update
97
97
  $ bun update @types/bun --latest
98
98
 
99
99
  # Update a dependency to a specific version
100
- $ bun update @types/bun@1.2.19-canary.20250713T140533
100
+ $ bun update @types/bun@1.2.19-canary.20250714T140751
101
101
 
102
102
  # Update all dependencies to the latest versions
103
103
  $ bun update --latest
@@ -21,7 +21,7 @@ Here's what the output of a typical test run looks like. In this case, there are
21
21
 
22
22
  ```sh
23
23
  $ bun test
24
- bun test v1.2.19-canary.20250713T140533 (9c68abdb)
24
+ bun test v1.2.19-canary.20250714T140751 (9c68abdb)
25
25
 
26
26
  test.test.js:
27
27
  ✓ add [0.87ms]
@@ -47,7 +47,7 @@ To only run certain test files, pass a positional argument to `bun test`. The ru
47
47
 
48
48
  ```sh
49
49
  $ bun test test3
50
- bun test v1.2.19-canary.20250713T140533 (9c68abdb)
50
+ bun test v1.2.19-canary.20250714T140751 (9c68abdb)
51
51
 
52
52
  test3.test.js:
53
53
  ✓ add [1.40ms]
@@ -85,7 +85,7 @@ Adding `-t add` will only run tests with "add" in the name. This works with test
85
85
 
86
86
  ```sh
87
87
  $ bun test -t add
88
- bun test v1.2.19-canary.20250713T140533 (9c68abdb)
88
+ bun test v1.2.19-canary.20250714T140751 (9c68abdb)
89
89
 
90
90
  test.test.js:
91
91
  ✓ add [1.79ms]
@@ -18,7 +18,7 @@ The first time this test is executed, Bun will evaluate the value passed into `e
18
18
 
19
19
  ```sh
20
20
  $ bun test test/snap
21
- bun test v1.2.19-canary.20250713T140533 (9c68abdb)
21
+ bun test v1.2.19-canary.20250714T140751 (9c68abdb)
22
22
 
23
23
  test/snap.test.ts:
24
24
  ✓ snapshot [1.48ms]
@@ -61,7 +61,7 @@ Later, when this test file is executed again, Bun will read the snapshot file an
61
61
 
62
62
  ```sh
63
63
  $ bun test
64
- bun test v1.2.19-canary.20250713T140533 (9c68abdb)
64
+ bun test v1.2.19-canary.20250714T140751 (9c68abdb)
65
65
 
66
66
  test/snap.test.ts:
67
67
  ✓ snapshot [1.05ms]
@@ -78,7 +78,7 @@ To update snapshots, use the `--update-snapshots` flag.
78
78
 
79
79
  ```sh
80
80
  $ bun test --update-snapshots
81
- bun test v1.2.19-canary.20250713T140533 (9c68abdb)
81
+ bun test v1.2.19-canary.20250714T140751 (9c68abdb)
82
82
 
83
83
  test/snap.test.ts:
84
84
  ✓ snapshot [0.86ms]
@@ -29,7 +29,7 @@ To regenerate snapshots, use the `--update-snapshots` flag.
29
29
 
30
30
  ```sh
31
31
  $ bun test --update-snapshots
32
- bun test v1.2.19-canary.20250713T140533 (9c68abdb)
32
+ bun test v1.2.19-canary.20250714T140751 (9c68abdb)
33
33
 
34
34
  test/snap.test.ts:
35
35
  ✓ snapshot [0.86ms]
@@ -5,7 +5,7 @@ name: Get the current Bun version
5
5
  Get the current version of Bun in a semver format.
6
6
 
7
7
  ```ts#index.ts
8
- Bun.version; // => "1.2.19-canary.20250713T140533"
8
+ Bun.version; // => "1.2.19-canary.20250714T140751"
9
9
  ```
10
10
 
11
11
  ---
@@ -14,7 +14,7 @@ Kernel version 5.6 or higher is strongly recommended, but the minimum is 5.1. Us
14
14
  ```bash#macOS/Linux_(curl)
15
15
  $ curl -fsSL https://bun.com/install | bash # for macOS, Linux, and WSL
16
16
  # to install a specific version
17
- $ curl -fsSL https://bun.com/install | bash -s "bun-v1.2.19-canary.20250713T140533"
17
+ $ curl -fsSL https://bun.com/install | bash -s "bun-v1.2.19-canary.20250714T140751"
18
18
  ```
19
19
 
20
20
  ```bash#npm
@@ -189,10 +189,10 @@ Since Bun is a single binary, you can install older versions of Bun by re-runnin
189
189
 
190
190
  ### Installing a specific version of Bun on Linux/Mac
191
191
 
192
- To install a specific version of Bun, you can pass the git tag of the version you want to install to the install script, such as `bun-v1.2.0` or `bun-v1.2.19-canary.20250713T140533`.
192
+ To install a specific version of Bun, you can pass the git tag of the version you want to install to the install script, such as `bun-v1.2.0` or `bun-v1.2.19-canary.20250714T140751`.
193
193
 
194
194
  ```sh
195
- $ curl -fsSL https://bun.com/install | bash -s "bun-v1.2.19-canary.20250713T140533"
195
+ $ curl -fsSL https://bun.com/install | bash -s "bun-v1.2.19-canary.20250714T140751"
196
196
  ```
197
197
 
198
198
  ### Installing a specific version of Bun on Windows
@@ -201,7 +201,7 @@ On Windows, you can install a specific version of Bun by passing the version num
201
201
 
202
202
  ```sh
203
203
  # PowerShell:
204
- $ iex "& {$(irm https://bun.com/install.ps1)} -Version 1.2.19-canary.20250713T140533"
204
+ $ iex "& {$(irm https://bun.com/install.ps1)} -Version 1.2.19-canary.20250714T140751"
205
205
  ```
206
206
 
207
207
  ## Downloading Bun binaries directly
@@ -108,6 +108,21 @@ The `telemetry` field permit to enable/disable the analytics records. Bun record
108
108
  telemetry = false
109
109
  ```
110
110
 
111
+ ### `console`
112
+
113
+ Configure console output behavior.
114
+
115
+ #### `console.depth`
116
+
117
+ Set the default depth for `console.log()` object inspection. Default `2`.
118
+
119
+ ```toml
120
+ [console]
121
+ depth = 3
122
+ ```
123
+
124
+ This controls how deeply nested objects are displayed in console output. Higher values show more nested properties but may produce verbose output for complex objects. This setting can be overridden by the `--console-depth` CLI flag.
125
+
111
126
  ## Test runner
112
127
 
113
128
  The test runner is configured under the `[test]` section of your bunfig.toml.
@@ -124,11 +124,11 @@ await fetch("https://example.com", {
124
124
  This prints the `fetch` request as a single-line `curl` command to let you copy-paste into your terminal to replicate the request.
125
125
 
126
126
  ```sh
127
- [fetch] $ curl --http1.1 "https://example.com/" -X POST -H "content-type: application/json" -H "Connection: keep-alive" -H "User-Agent: Bun/1.2.19-canary.20250713T140533" -H "Accept: */*" -H "Host: example.com" -H "Accept-Encoding: gzip, deflate, br" --compressed -H "Content-Length: 13" --data-raw "{\"foo\":\"bar\"}"
127
+ [fetch] $ curl --http1.1 "https://example.com/" -X POST -H "content-type: application/json" -H "Connection: keep-alive" -H "User-Agent: Bun/1.2.19-canary.20250714T140751" -H "Accept: */*" -H "Host: example.com" -H "Accept-Encoding: gzip, deflate, br" --compressed -H "Content-Length: 13" --data-raw "{\"foo\":\"bar\"}"
128
128
  [fetch] > HTTP/1.1 POST https://example.com/
129
129
  [fetch] > content-type: application/json
130
130
  [fetch] > Connection: keep-alive
131
- [fetch] > User-Agent: Bun/1.2.19-canary.20250713T140533
131
+ [fetch] > User-Agent: Bun/1.2.19-canary.20250714T140751
132
132
  [fetch] > Accept: */*
133
133
  [fetch] > Host: example.com
134
134
  [fetch] > Accept-Encoding: gzip, deflate, br
@@ -170,7 +170,7 @@ This prints the following to the console:
170
170
  [fetch] > HTTP/1.1 POST https://example.com/
171
171
  [fetch] > content-type: application/json
172
172
  [fetch] > Connection: keep-alive
173
- [fetch] > User-Agent: Bun/1.2.19-canary.20250713T140533
173
+ [fetch] > User-Agent: Bun/1.2.19-canary.20250714T140751
174
174
  [fetch] > Accept: */*
175
175
  [fetch] > Host: example.com
176
176
  [fetch] > Accept-Encoding: gzip, deflate, br
package/docs/test/dom.md CHANGED
@@ -55,7 +55,7 @@ Let's run this test with `bun test`:
55
55
 
56
56
  ```bash
57
57
  $ bun test
58
- bun test v1.2.19-canary.20250713T140533
58
+ bun test v1.2.19-canary.20250714T140751
59
59
 
60
60
  dom.test.ts:
61
61
  ✓ dom test [0.82ms]
package/package.json CHANGED
@@ -1,5 +1,5 @@
1
1
  {
2
- "version": "1.2.19-canary.20250713T140533",
2
+ "version": "1.2.19-canary.20250714T140751",
3
3
  "name": "bun-types",
4
4
  "license": "MIT",
5
5
  "types": "./index.d.ts",