Главная страница>Связанные с программированием>Другой исходный код
Скачать

Авто -драматург

Запустите драматурные тесты с использованием искусственного интеллекта.

Настраивать

  1. Установите зависимость auto-playwright : 
npm install auto-playwright -D
  1. Этот пакет основан на разговоре с OpenAI (https://openai.com/). Вы должны экспортировать токен API в качестве переменной среды окружающей среды или добавить его в свой файл .env : 
 export OPENAI_API_KEY= ' sk-..."
  1. Импортируйте и используйте функцию auto : 
 import { test , expect } from "@playwright/test" ;
import { auto } from "auto-playwright" ;

test ( "auto Playwright example" , async ( { page } ) => {
  await page . goto ( "/" ) ;

  // `auto` can query data
  // In this case, the result is plain-text contents of the header
  const headerText = await auto ( "get the header text" , { page , test } ) ;

  // `auto` can perform actions
  // In this case, auto will find and fill in the search text input
  await auto ( `Type " ${ headerText } " in the search box` , { page , test } ) ;

  // `auto` can assert the state of the website
  // In this case, the result is a boolean outcome
  const searchInputHasHeaderText = await auto ( `Is the contents of the search box equal to " ${ headerText } "?` , { page , test } ) ;

  expect ( searchInputHasHeaderText ) . toBe ( true ) ;
} ) ;

Настройка с Azure OpenAI

Включите тип от Stescoptions с значениями, необходимыми для подключения к Azure OpenaI. 

 import { test , expect } from "@playwright/test" ;
import { auto } from "auto-playwright" ;
import { StepOptions } from "../src/types" ;

const apiKey = "apikey" ;
const resource = "azure-resource-name" ;
const model = "model-deployment-name" ;

const options : StepOptions = {
   model : model ,
   openaiApiKey : apiKey ,
   openaiBaseUrl : `https:// ${ resource } .openai.azure.com/openai/deployments/ ${ model } ` ,
   openaiDefaultQuery : { 'api-version' : "2023-07-01-preview" } ,
   openaiDefaultHeaders : { 'api-key' : apiKey }
} ;

test ( "auto Playwright example" , async ( { page } ) => {
  await page . goto ( "/" ) ;

  // `auto` can query data
  // In this case, the result is plain-text contents of the header
  const headerText = await auto ( "get the header text" , { page , test } , options ) ;

  // `auto` can perform actions
  // In this case, auto will find and fill in the search text input
  await auto ( `Type " ${ headerText } " in the search box` , { page , test } , options ) ;

  // `auto` can assert the state of the website
  // In this case, the result is a boolean outcome
  const searchInputHasHeaderText = await auto ( `Is the contents of the search box equal to " ${ headerText } "?` , { page , test } , options ) ;

  expect ( searchInputHasHeaderText ) . toBe ( true ) ;
} ) ;

Использование

Как минимум, auto требует простой текстовой подсказки и аргумента , который содержит вашу page и test (необязательные) объекты. 

 auto ( "<your prompt>" , { page , test } ) ;

Автоматизация браузера

Запуск без параметра test : 

 import { chromium } from "playwright" ;
import { auto } from "auto-playwright" ;

( async ( ) => {
  const browser = await chromium . launch ( { headless : true } ) ;
  const context = await browser . newContext ( ) ;
  const page = await context . newPage ( ) ;
  // Navigate to a website
  await page . goto ( "https://www.example.com" ) ;

  // `auto` can query data
  // In this case, the result is plain-text contents of the header
  const res = await auto ( "get the header text" , { page } ) ;

  // use res.query to get a query result.
  console . log ( res ) ;
  await page . close ( ) ;
} ) ( ) ;

Отлаживать

Вы можете передать атрибут debug в качестве третьего параметра в auto . Это распечатает подсказку и команды, выполненные OpenAI. 

 await auto ( "get the header text" , { page , test } , { debug : true } ) ;

Вы также можете установить переменную среды AUTO_PLAYWRIGHT_DEBUG=true , которая позволит отладке для всех auto вызовов. 

 export AUTO_PLAYWRIGHT_DEBUG=true

Поддерживаемые браузеры

Каждый браузер, который поддерживает драматург.

Дополнительные варианты

Есть дополнительные варианты, которые вы можете пройти в качестве третьего аргумента: 

 const options = {
  // If true, debugging information is printed in the console.
  debug : boolean ,
  // The OpenAI model (https://platform.openai.com/docs/models/overview)
  model : "gpt-4-1106-preview" ,
  // The OpenAI API key
  openaiApiKey : 'sk-...' ,
} ;

auto ( "<your prompt>" , { page , test } , options ) ;

Поддерживаемые действия и возвратные значения

В зависимости от type действия (вывод, выведенного в результате функции auto ), существуют различные поведения и типы возврата.

Действие

Действие (например, «клик») - это какое -то моделируемое взаимодействие с пользователем со страницей, например, нажмите на ссылку. Действия вернутся `неопределенные` `, если они были успешными, и вынесут ошибку, если они потерпят неудачу, например, 

 try {
  await auto ( "click the link" , { page , test } ) ;
} catch ( e ) {
  console . error ( "failed to click the link" ) ;
}

Запрос

Запрос будет возвращать запрошенные данные со страницы в качестве строки, например, 

 const linkText = await auto ( "Get the text of the first link" , { page , test } ) ;

console . log ( "The link text is" , linkText ) ;

Утверждать

Утверждение - это вопрос, который вернет true или false , например, 

 const thereAreThreeLinks = await auto ( "Are there 3 links on the page?" , {
  page ,
  test ,
} ) ;

console . log ( `"There are 3 links" is a ${ thereAreThreeLinks } statement` ) ;

Зачем использовать Auto Playwright?

Аспект Обычный подход Тестирование с авточазией Auto
Соединение с разметкой Сильно связан с разметкой приложения. Устраняет использование селекторов; Действия определяются помощником ИИ во время выполнения.
Скорость реализации Более медленная реализация из -за необходимости точного перевода кода для каждого действия. Быстрое создание тестов с использованием простых, простых текстовых инструкций для действий и утверждений.
Обработка сложных сценариев Автоматизация сложных сценариев является сложной и подверженной частым сбоям. Облегчает тестирование сложных сценариев, сосредотачиваясь на предполагаемых результатах теста.
Тест написания времени Может написать тесты только после полной разработки функциональности. Включает подход к тестовым разработке (TDD), позволяющий одновременно одновременно с или до разработки функциональности или до разработки функций.

Поддерживаемые драматургии

  • locator.blur
  • locator.boundingBox
  • locator.check
  • locator.clear
  • locator.click
  • locator.count
  • locator.fill
  • locator.getAttribute
  • locator.innerHTML
  • locator.innerText
  • locator.inputValue
  • locator.isChecked
  • locator.isEditable
  • locator.isEnabled
  • locator.isVisible
  • locator.textContent
  • locator.uncheck
  • page.goto

Добавление новых действий легко: просто обновите functions в src/completeTask.ts .

Ценообразование

Эта библиотека бесплатна. Тем не менее, есть затраты, связанные с использованием OpenAI. Вы можете найти больше информации о ценах здесь: https://openai.com/pricing/.

Пример

Используя https://ray.run/ в качестве примера, стоимость выполнения стадии испытаний составляет приблизительно 0,01 долл. США с использованием GPT-4 Turbo (и 0,001 долл. США с использованием GPT-3.5 Turbo).

Низкая стоимость частично связана с тем, что auto-playwright использует санитизацию HTML для уменьшения размера полезной нагрузки, например, то, что следует, полезная нагрузка, которая будет представлена ​​для https://ray.run/.

Естественно, цена будет сильно различаться в зависимости от полезной нагрузки. 

 < div class =" cYdhWw dKnOgO geGbZz bGoBgk jkEels " >
  < div class =" kSmiQp fPSBzf bnYmbW dXscgu xJzwH jTWvec gzBMzy " >
    < h1 class =" fwYeZS fwlORb pdjVK bccLBY fsAQjR fyszFl WNJim fzozfU " >
      Learn Playwright
    </ h1 >
    < h2 class =" cakMWc ptfck bBmAxp hSiiri xJzwS gnfYng jTWvec fzozfU " >
      Resources for learning end-to-end testing using Playwright automation
      framework
    </ h2 >
    < div
      class =" bLTbYS gvHvKe cHEBuD ddgODW jsxhGC kdTEUJ ilCTXp iQHbtH yuxBn ilIXfy gPeiPq ivcdqp isDTsq jyZWmS ivdkBK cERSkX hdAwi ezvbLT jNrAaV jsxhGJ fzozCb "
    > </ div >
  </ div >
  < div class =" cYdhWw dpjphg cqUdSC fasMpP " >
    < a
      class =" gacSWM dCgFix conipm knkqUc bddCnd dTKJOB leOtqz hEzNkW fNBBKe jTWvec fIMbrO fzozfU group "
      href =" /blog "
      > < div class =" plfYl bccLBY hSiiri fNBpvX " > Blog </ div >
      < div class =" jqqjPD fWDXZB pKTba bBmAxp hSiiri evbPEu " >
        < p > Learn in depth subjects about end-to-end testing. </ p >
      </ div > </ a
    > < a
      class =" gacSWM dCgFix conipm knkqUc bddCnd dTKJOB leOtqz hEzNkW fNBBKe jTWvec fIMbrO fzozfU group "
      href =" /ask "
      > < div class =" plfYl bccLBY hSiiri fNBpvX " > Ask AI </ div >
      < div class =" jqqjPD fWDXZB pKTba bBmAxp hSiiri evbPEu " >
        < p > Ask ChatGPT Playwright questions. </ p >
      </ div > </ a
    > < a
      class =" gacSWM dCgFix conipm knkqUc bddCnd dTKJOB leOtqz hEzNkW fNBBKe jTWvec fIMbrO fzozfU group "
      href =" /tools "
      > < div class =" plfYl bccLBY hSiiri fNBpvX " > Dev Tools </ div >
      < div class =" jqqjPD fWDXZB pKTba bBmAxp hSiiri evbPEu " >
        < p > All-in-one toolbox for QA engineers. </ p >
      </ div > </ a
    > < a
      class =" gacSWM dCgFix conipm knkqUc bddCnd dTKJOB leOtqz hEzNkW fNBBKe jTWvec fIMbrO fzozfU group "
      href =" /jobs "
      > < div class =" plfYl bccLBY hSiiri fNBpvX " > QA Jobs </ div >
      < div class =" jqqjPD fWDXZB pKTba bBmAxp hSiiri evbPEu " >
        < p > Handpicked QA and Automation opportunities. </ p >
      </ div > </ a
    > < a
      class =" gacSWM dCgFix conipm knkqUc bddCnd dTKJOB leOtqz hEzNkW fNBBKe jTWvec fIMbrO fzozfU group "
      href =" /questions "
      > < div class =" plfYl bccLBY hSiiri fNBpvX " > Questions </ div >
      < div class =" jqqjPD fWDXZB pKTba bBmAxp hSiiri evbPEu " >
        < p > Ask AI answered questions about Playwright. </ p >
      </ div > </ a
    > < a
      class =" gacSWM dCgFix conipm knkqUc bddCnd dTKJOB leOtqz hEzNkW fNBBKe jTWvec fIMbrO fzozfU group "
      href =" /discord-forum "
      > < div class =" plfYl bccLBY hSiiri fNBpvX " > Discord Forum </ div >
      < div class =" jqqjPD fWDXZB pKTba bBmAxp hSiiri evbPEu " >
        < p > Archive of Discord Forum posts about Playwright. </ p >
      </ div > </ a
    > < a
      class =" gacSWM dCgFix conipm knkqUc bddCnd dTKJOB leOtqz hEzNkW fNBBKe jTWvec fIMbrO fzozfU group "
      href =" /videos "
      > < div class =" plfYl bccLBY hSiiri fNBpvX " > Videos </ div >
      < div class =" jqqjPD fWDXZB pKTba bBmAxp hSiiri evbPEu " >
        < p > Tutorials, conference talks, and release videos. </ p >
      </ div > </ a
    > < a
      class =" gacSWM dCgFix conipm knkqUc bddCnd dTKJOB leOtqz hEzNkW fNBBKe jTWvec fIMbrO fzozfU group "
      href =" /browser-extension "
      > < div class =" plfYl bccLBY hSiiri fNBpvX " > Browser Extension </ div >
      < div class =" jqqjPD fWDXZB pKTba bBmAxp hSiiri evbPEu " >
        < p > GUI for generating Playwright locators. </ p >
      </ div > </ a
    > < a
      class =" gacSWM dCgFix conipm knkqUc bddCnd dTKJOB leOtqz hEzNkW fNBBKe jTWvec fIMbrO fzozfU group "
      href =" /wiki "
      > < div class =" plfYl bccLBY hSiiri fNBpvX " > QA Wiki </ div >
      < div class =" jqqjPD fWDXZB pKTba bBmAxp hSiiri evbPEu " >
        < p > Definitions of common end-to-end testing terms. </ p >
      </ div > </ a
    >
  </ div >
  < div
    class =" kSmiQp fPSBzf pKTba eTDpsp legDhJ hSiiri hdaZLM jTWvec gzBMzy bGySga fzoybr "
  >
    < p class =" dXhlDK leOtqz glpWRZ fNCcFz " >
      Use < kbd class =" bWhrAL XAzZz cakMWc bUyOMB bmOrOm fyszFl dTmriP " > ⌘ </ kbd > +
      < kbd > k </ kbd > + "Tools" to quickly access all tools.
    </ p >
  </ div >
</ div >

Выполнение

HTML -дезинтезирование

Функция auto использует Sanitize-HTML для дезинфекции HTML страницы перед отправкой в ​​OpenAI. Это сделано для снижения стоимости и повышения качества сгенерированного текста.

Zerostep

Этот проект черпает вдохновение в Zerostep. Zerostep предлагает аналогичный API, но с более надежной реализацией через свой частный бэкэнд. Auto Playwright был создан с целью изучения основной технологии Zerostep и создания основы для версии их программного обеспечения с открытым исходным кодом. Для производственных среду я предлагаю выбрать Zerostep.

Вот бок о бок сравнение Auto Playwright и Zerostep:

Критерии Авто -драматург Zerostep
Использует API OpenAI Да № 1
Использует простые текстовые подсказки Да Нет
Использует functions SDK Да Нет
Использует HTML -дезинфицирование Да Нет
Использует Playwright API Да № 2
Использует скриншоты Нет Да
Использует очередь Нет Да
Использует веб -токеты Нет Да
Снимки HTML Дом
Реализации параллелизма Нет Да
Позволяет прокручивать Нет Да
Обеспечивает приспособления Нет Да
Лицензия Грань Грань
Zero STEP Лицензия 
 MIT License

Copyright (c) 2023 Reflect Software Inc

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Сноски

  1. Использует запатентованную API Zerostep. ↩

  2. Использует некоторый Playwright API, но преимущественно полагается на протокол Chrome Devtools (CDP). ↩

Расширять
Дополнительная информация
Связанные приложения
Рекомендуем вам
Связанные новости Все