شروع به کار
نصب
ساده‌ترین راه برای نگه داشتن @wdio/ocr-service به عنوان وابستگی در فایل package.json شما از طریق دستور زیر است.
- npm
- Yarn
- pnpm
npm install @wdio/ocr-service --save-dev
yarn add @wdio/ocr-service --dev
pnpm add @wdio/ocr-service --save-dev
دستورالعمل نصب WebdriverIO را می‌توانید اینجا پیدا کنید.
این ماژول از Tesseract به عنوان موتور OCR استفاده می‌کند. به طور پیش‌فرض، بررسی می‌کند که آیا نصب محلی Tesseract روی سیستم شما وجود دارد، اگر وجود داشته باشد، از آن استفاده می‌کند. در غیر این صورت، از ماژول Node.js Tesseract.js استفاده می‌کند که به طور خودکار برای شما نصب می‌شود.
اگر می‌خواهید پردازش تصویر را سریع‌تر کنید، توصیه می‌شود از نسخه نصب شده محلی Tesseract استفاده کنید. همچنین به زمان اجرای تست مراجعه کنید.
دستورالعمل نصب Tesseract به عنوان وابستگی سیستم در سیستم محلی شما را می‌توانید اینجا پیدا کنید.
برای سوالات/خطاهای نصب Tesseract لطفاً به پروژه Tesseract مراجعه کنید.
پشتیبانی از Typescript
اطمینان حاصل کنید که @wdio/ocr-service را به فایل پیکربندی tsconfig.json خود اضافه کرده‌اید.
{
"compilerOptions": {
"types": ["node", "@wdio/globals/types", "@wdio/ocr-service"]
}
}
پیکربندی
برای استفاده از این سرویس باید ocr را به آرایه سرویس‌های خود در wdio.conf.ts اضافه کنید
// wdio.conf.js
exports.config = {
//...
services: [
// your other services
[
"ocr",
{
contrast: 0.25,
imagesFolder: ".tmp/",
language: "eng",
},
],
],
};
گزینه‌های پیکربندی
contrast
- نوع:
number - اجباری: خیر
- پیش‌فرض:
0.25
هرچه کنتراست بالاتر باشد، تصویر تیره‌تر می‌شود و برعکس. این می‌تواند به یافتن متن در تصویر کمک کند. مقادیر بین -1 و 1 را می‌پذیرد.
imagesFolder
- نوع:
string - اجباری: خیر
- پیش‌فرض:
{project-root}/.tmp/ocr
پوشه‌ای که نتایج OCR در آن ذخیره می‌شوند.
اگر یک imagesFolder سفارشی ارائه دهید، سرویس به طور خودکار زیرپوشه ocr را به آن اضافه می‌کند.
language
- نوع:
string - اجباری: خیر
- پیش‌فرض:
eng
زبانی که Tesseract شناسایی خواهد کرد. اطلاعات بیشتر را می‌توانید اینجا پیدا کنید و زبان‌های پشتیبانی شده را می‌توانید اینجا پیدا کنید.
گزارش‌ها
این ماژول به طور خودکار گزارش‌های اضافی را به گزارش‌های WebdriverIO اضافه می‌کند. آن به گزارش‌های INFO و WARN با نام @wdio/ocr-service می‌نویسد.
نمونه‌ها را می‌توانید در زیر پیدا کنید.
...............
[0-0] 2024-05-24T06:55:12.739Z INFO @wdio/ocr-service: Adding commands to global browser
[0-0] 2024-05-24T06:55:12.750Z INFO @wdio/ocr-service: Adding browser command "ocrGetText" to browser object
[0-0] 2024-05-24T06:55:12.751Z INFO @wdio/ocr-service: Adding browser command "ocrGetElementPositionByText" to browser object
[0-0] 2024-05-24T06:55:12.751Z INFO @wdio/ocr-service: Adding browser command "ocrWaitForTextDisplayed" to browser object
[0-0] 2024-05-24T06:55:12.751Z INFO @wdio/ocr-service: Adding browser command "ocrClickOnText" to browser object
[0-0] 2024-05-24T06:55:12.751Z INFO @wdio/ocr-service: Adding browser command "ocrSetValue" to browser object
...............
[0-0] 2024-05-24T06:55:13.667Z INFO @wdio/ocr-service:getData: Using system installed version of Tesseract
[0-0] 2024-05-24T06:55:14.019Z INFO @wdio/ocr-service:getData: It took '0.351s' to process the image.
[0-0] 2024-05-24T06:55:14.019Z INFO @wdio/ocr-service:getData: The following text was found through OCR:
[0-0]
[0-0] IQ Docs API Blog Contribute Community Sponsor Next-gen browser and mobile automation Welcome! How can | help? i test framework for Node.js Get Started Why WebdriverI0? View on GitHub Watch on YouTube
[0-0] 2024-05-24T06:55:14.019Z INFO @wdio/ocr-service:getData: OCR Image with found text can be found here:
[0-0]
[0-0] .tmp/ocr/desktop-1716533713585.png
[0-0] 2024-05-24T06:55:14.019Z INFO @wdio/ocr-service:ocrGetElementPositionByText: We searched for the word "Get Started" and found one match "Started" with score "63.64
...............
