Skip to content

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.ts
index 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.ts
index 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 pool
for (let i = 0; i < this.concurrency; i++) {