# مكتبة Puppeteer لإتمتة المتصفح (Chrome او Chromium)

**URL:** <https://discourse.aosus.org/t/topic/2518>\
**Category:** البرمجة\
**Created:** [2 أغسطس 2022، 11:25م UTC](https://discourse.aosus.org/t/topic/2518 "2022-08-02T23:25:28Z")\
**Posts on this page:** 1\
**Showing post:** 1

<div class="post-metadata">

**Author:** ![Rnx](https://discourse.aosus.org/user_avatar/discourse.aosus.org/rnx/32/5161_2.png) [@Rnx](https://discourse.aosus.org/u/Rnx)\
**Post date:** [2 أغسطس 2022، 11:25م UTC](https://discourse.aosus.org/t/topic/2518/1 "2022-08-02T23:25:28Z")

</div>

![Puppeteer](https://cdn-cf-discourse.aosus.org/original/2X/8/85ca862822285943f84bed9588bf3c5589d3e087.png)

# 

# ماهو Puppeteer او محرك العرائس

# 

هي مكتبة لـ Nodejs توفر واجهة برمجة تطبيقات ( **api** ) عالية المستوى للتحكم في Chrome أو Chromium عبر بروتوكول DevTools.  
يعمل Puppeteer بدون رأس ( **في الخلفية** ) افتراضيًا ، ولكن يمكن تهيئته لتشغيل Chrome أو Chromium بالكامل

# ماذا يمكنه أن يفعل؟

# 

- يمكنك إنشاء لقطات شاشة وملفات PDF للصفحات.
- أتمتة إرسال النماذج واختبار واجهة المستخدم وإدخال لوحة المفاتيح الخ..
- قم بإنشاء بيئة اختبار مؤتمتة ومحدثة. قم بإجراء اختباراتك مباشرةً في أحدث إصدار من Chrome باستخدام أحدث ميزات JavaScript والمتصفح.
- مخطط زمني لموقعك للمساعدة في تشخيص مشكلات الأداء.
- اختبار ملحقات كروم.

# تثبيت Puppeteer

# 

لاستخدام محرك العرائس في مشروعك , قم بتشغيل الامر التالي

```auto
npm i puppeteer

```

عند ثبيت محرك العرائس ، فإنه يقوم بتنزيل إصدار حديث من Chromium مضمون للعمل مع واجهة برمجة التطبيقات

# 

**لإستدعاء المكتبة في مشروعنا**

# 

```auto
const puppeteer = require('puppeteer');

```

# 

او

# 

```auto
import puppeteer from 'puppeteer';

```

# 

مثال index.js | إلتقاط صورة للموقع

# 

```auto

import puppeteer from 'puppeteer';

const browser = await puppeteer.launch();
const page = await browser.newPage();
await page.goto('https://discourse.aosus.org');
await page.screenshot({ path: 'example.png' });

await browser.close();

```

# 

نقوم بتنفيذ البرنامج النصي index.js

```auto
node index.js 

```

# 

لان في نفس مجلد المشروع راح نحصل صورة الموقع بإسم example.png

# 

 ![example](https://cdn-cf-discourse.aosus.org/original/2X/9/98d53ecb9c2474c033b20f27bc33a177ace9d1c0.png)

# 

.

# 

الان سأقوم بكتابة برنامج نصي لتسجيل الدخول على موقع اسس والتعليق على احد المواضيع

# 

سأقوم بالتعليق على موضوع الأخ @usama_makhzoum

> [@Serious sam classic تتوفر على لينكس](https://discourse.aosus.org/t/topic/2516):
>
> السلام عليكم بعد 12 سنة من إصدار أول إصدار من اللعبة المعروفة serious sam ، فتحت [كروتيم](http://www.croteam.com/) مصدر محركها serious engine 1 ، للعلم اللعبة نفسها كانت تتوفر للينكس ولكن منذ البداية لم تكن حرة أو حتى مجانية ، يمكنك الآن لعب اللعبة بعد ما فتح مصدرها مجانا لكل من SS the first encounter & the second encounter رابط المستودع

# 

.

# 

مثال لملف index.js  
قم بتغير headless الى false لترى المتصفح او ابقيها على true لتعمل في الخلفية

# 

```auto

import puppeteer from 'puppeteer';

let browser = await puppeteer.launch({ headless: true , devtools: false }); // بدء تشغيل محرك العرائس
let page = await browser.newPage(); // إنشاء صفحة جديدة في سياق المستعرض الافتراضي
page.setDefaultNavigationTimeout(0); // سيؤدي هذا الإعداد إلى تغيير الحد الأقصى الافتراضي لوقت التنقل
//page.setDefaultTimeout(0);
let url_example = 'https://discourse.aosus.org/t/topic/2516'// عنوان url للصفحة
let message = "شكرا لك سألقى لها نظره قريباً"
let username = 'rn0x' // نضع هنا الإيميل او اليوزر
let password = " ***********" // رمز الدخول

let status = await page.goto(url_example, {
    waitUntil: 'load',
    timeout: 0
}); 

status = status.status();

if (status === 200) {

    await page.$$eval('.d-button-label', (e) => {

        e.map(e => {

            if (e.textContent === 'تسجيل دخول') {

                e.click()

            }
        })
    });
    let username_input = await page.waitForSelector('#login-account-name')
    await username_input.type(username, { delay: 100 })
    let password_input = await page.waitForSelector('#login-account-password')
    await password_input.type(password, { delay: 100 })
    await page.click('#login-button');
    await new Promise(r => setTimeout(r, 5000));
    let modal_alert = await page.waitForSelector('#modal-alert')
    let Log_in_error = await modal_alert.evaluate(e => e.innerHTML);

    if (Log_in_error === 'اسم المستخدم أو البريد الإلكتروني أو كلمة المرور غير صحيحة') {

        console.log('Username, email or password incorrect');

    }

    else if (Log_in_error === '') {

        console.log('You are logged in successfully');

        let comm = await page.waitForSelector('.post-menu-area .actions .d-button-label');
        await comm.click()
        let msg = await page.waitForSelector('.d-editor-input')
        await msg.type(message, { delay: 100 });
        let send = await page.waitForSelector('.save-or-cancel .d-button-label');
        await send.click()

    }

}

else {

    console.log(` HTTP response status code ${status}`);
}

await browser.close();

```

# 

نقوم بتنفيذ البرنامج النصي index.js

```auto
node index.js 

```

# 

# 

صورة من المتصفح

# 

![ezgif.com-gif-maker](https://cdn-cf-discourse.aosus.org/original/2X/2/2a244eabe590b56451c52fc49f7141ab62c9bacc.gif)

# 

## للمزيد من المعلومات عن محرك العرائس تفضل بزيارة الموقع الرسمي

> **[API Reference | Puppeteer](https://pptr.dev/api)**
>
> Classes

## هذا الموضوع فائز [بجائزة أسس للكتابة](https://aosus.org/writing-contest?utm_campaign=awc&source=discourse-gnulinuxsa-notice)

هذا الموضوع فائز [بجائزة أسس للكتابة](https://aosus.org/writing-contest?utm_campaign=awc&source=discourse-gnulinuxsa-notice) وهي اول جائزة عربية مخصصة للكتابة عن البرمجيات الحرة والمفتوحة.

الموضوع متوفر على مدونة gnulinuxsa هنا:

> **[مكتبة Puppeteer لإتمتة المتصفح (Chrome او Chromium)](https://gnulinuxsa.org/archives/38639/?utm_campaign=awc&source=discourse-gnulinuxsa-notice)**
>
> ماهو Puppeteer او محرك العرائس هي مكتبة لـ Nodejs توفر واجهة برمجة تطبيقات ( api ) عالية المستوى للتحكم في Chrome أو Chromium عبر بروتوكول DevTools. يعمل Puppeteer بدون رأس ( في الخلفية ) افتراضيًا ، ولكن يمكن تهيئته لتشغيل Chrome أو Chromium...

---

_[View the full topic](https://discourse.aosus.org/t/topic/2518)._
