[wrangler] handle fs errors in r2 put (#11178)

ascorbic · web-flow · commit 63defa28c825 · 2025-11-07T10:13:24.000Z
* [wrangler] handle fs errors in r2 put

* Use UserError
diff --git a/.changeset/flat-buses-give.md b/.changeset/flat-buses-give.md
@@ -0,0 +1,5 @@
+---
+"wrangler": patch
+---
+
+Log a more helpful error when attempting to "r2 object put" a non-existent file
diff --git a/packages/wrangler/src/__tests__/r2/errors.test.ts b/packages/wrangler/src/__tests__/r2/errors.test.ts
@@ -0,0 +1,18 @@
+import { mockConsoleMethods } from "../helpers/mock-console";
+import { runInTempDir } from "../helpers/run-in-tmp";
+import { runWrangler } from "../helpers/run-wrangler";
+
+describe("r2 errors", () => {
+	mockConsoleMethods();
+	runInTempDir();
+
+	it("should throw a helpful error if attempting to put a missing file", async () => {
+		const result = runWrangler(
+			`r2 object put bucket-object-test/missing-file.txt --file ./missing-file.txt `
+		);
+
+		await expect(result).rejects.toThrowErrorMatchingInlineSnapshot(
+			`[Error: The file "./missing-file.txt" does not exist.]`
+		);
+	});
+});
diff --git a/packages/wrangler/src/r2/object.ts b/packages/wrangler/src/r2/object.ts
@@ -259,9 +259,22 @@ export const r2ObjectPutCommand = createCommand({
 		let object: ReadableStream;
 		let objectSize: number;
 		if (file) {
-			object = await createFileReadableStream(file);
-			const stats = fs.statSync(file);
-			objectSize = stats.size;
+			try {
+				const stats = fs.statSync(file);
+				objectSize = stats.size;
+				object = await createFileReadableStream(file);
+			} catch (err) {
+				if ((err as NodeJS.ErrnoException).code === "ENOENT") {
+					throw new UserError(`The file "${file}" does not exist.`);
+				}
+				const error = new UserError(
+					`An error occurred while trying to read the file "${file}": ${
+						(err as Error).message
+					}`
+				);
+				error.cause = err;
+				throw error;
+			}
 		} else {
 			const buffer = await new Promise<Buffer>((resolve, reject) => {
 				const stdin = process.stdin;

-Original file line number
+Diff line change
@@ @@ -0,0 +1,5 @@ @@
 +---
 +"wrangler": patch
 +---
++
 +Log a more helpful error when attempting to "r2 object put" a non-existent file