Add --console-depth CLI flag and console.depth bunfig option (#21016)

Co-authored-by: Claude Bot <claude-bot@bun.sh>
Co-authored-by: Claude <noreply@anthropic.com>
Co-authored-by: jarred-sumner-bot <220441119+jarred-sumner-bot@users.noreply.github.com>
Co-authored-by: Jarred Sumner <jarred@jarredsumner.com>

docs/api/console.md

@@ -2,6 +2,25 @@
 **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.
 {% /callout %}
 
+## Object inspection depth
+
+Bun allows you to configure how deeply nested objects are displayed in `console.log()` output:
+
+- **CLI flag**: Use `--console-depth <number>` to set the depth for a single run
+- **Configuration**: Set `console.depth` in your `bunfig.toml` for persistent configuration
+- **Default**: Objects are inspected to a depth of `2` levels
+
+```js
+const nested = { a: { b: { c: { d: "deep" } } } };
+console.log(nested);
+// Default (depth 2): { a: { b: [Object] } }
+// With depth 4: { a: { b: { c: { d: 'deep' } } } }
+```
+
+The CLI flag takes precedence over the configuration file setting.
+
+## Reading from stdin
+
 In Bun, the `console` object can be used as an `AsyncIterable` to sequentially read lines from `process.stdin`.
 
 ```ts

docs/cli/run.md

@@ -185,6 +185,23 @@ This is TypeScript!
 
 For convenience, all code is treated as TypeScript with JSX support when using `bun run -`.
 
+## `bun run --console-depth`
+
+Control the depth of object inspection in console output with the `--console-depth` flag.
+
+```bash
+$ bun --console-depth 5 run index.tsx
+```
+
+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.
+
+```js
+const nested = { a: { b: { c: { d: "deep" } } } };
+console.log(nested);
+// With --console-depth 2 (default): { a: { b: [Object] } }
+// With --console-depth 4: { a: { b: { c: { d: 'deep' } } } }
+```
+
 ## `bun run --smol`
 
 In memory-constrained environments, use the `--smol` flag to reduce memory usage at a cost to performance.

docs/runtime/bunfig.md

@@ -108,6 +108,21 @@ The `telemetry` field permit to enable/disable the analytics records. Bun record
 telemetry = false
 ```
 
+### `console`
+
+Configure console output behavior.
+
+#### `console.depth`
+
+Set the default depth for `console.log()` object inspection. Default `2`.
+
+```toml
+[console]
+depth = 3
+```
+
+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.
+
 ## Test runner
 
 The test runner is configured under the `[test]` section of your bunfig.toml.