A fast, helpful, and open-source document parser
fix(ocr): handle tesseract worker fetch failures
Co-Messi661cba5a0833
diff --git a/src/engines/ocr/tesseract.test.ts b/src/engines/ocr/tesseract.test.tsindex e368ffb..2385ce7 100644--- a/src/engines/ocr/tesseract.test.ts+++ b/src/engines/ocr/tesseract.test.ts@@ -56,12 +56,18 @@ vi.mock("tesseract.js", async () => {const actual = await vi.importActual<typeof import("tesseract.js")>("tesseract.js");return {...actual,- createWorker: vi.fn(async (language: string, _num: number) => {- if (language == "it" || language == "ita") {- return;+ createWorker: vi.fn(+ async (language: string, _num: number, options?: { errorHandler?: (arg: any) => void }) => {+ if (language == "it" || language == "ita") {+ return;+ }+ if (language == "offline" || language == "fetchfail") {+ options?.errorHandler?.("TypeError: fetch failed");+ throw new Error("TypeError: fetch failed");+ }+ return mockTesseractWorker;}- return mockTesseractWorker;- }),+ ),};});@@ -82,6 +88,13 @@ describe("test Tesseract OCR (single image)", () => {"Tesseract worker not initialized");});++ it("test engine failure (fetch failed) returns actionable guidance", async () => {+ const engine = new TesseractEngine();+ await expect(engine.recognize("cat.png", { language: "offline" })).rejects.toThrow(+ 'Tesseract failed to download language data for "offline"'+ );+ });});describe("test OCR simple HTTP server (batch)", () => {diff --git a/src/engines/ocr/tesseract.ts b/src/engines/ocr/tesseract.tsindex bd9a962..87b7abd 100644--- a/src/engines/ocr/tesseract.ts+++ b/src/engines/ocr/tesseract.ts@@ -33,6 +33,10 @@ export class TesseractEngine implements OcrEngine {workerOptions.cachePath = this.tessdataPath;workerOptions.gzip = false; // Pre-cached files are not gzipped}+ workerOptions.errorHandler = () => {+ // Let createWorker reject so LiteParse can convert the failure into+ // an actionable initialization error instead of crashing the process.+ };// Create worker poolfor (let i = 0; i < this.concurrency; i++) {