argra****@users*****
argra****@users*****
2012年 10月 10日 (水) 00:36:10 JST
Index: docs/modules/HTTP-WebTest-2.04/lib/HTTP/WebTest.pod diff -u docs/modules/HTTP-WebTest-2.04/lib/HTTP/WebTest.pod:1.3 docs/modules/HTTP-WebTest-2.04/lib/HTTP/WebTest.pod:1.4 --- docs/modules/HTTP-WebTest-2.04/lib/HTTP/WebTest.pod:1.3 Mon Feb 7 02:53:00 2011 +++ docs/modules/HTTP-WebTest-2.04/lib/HTTP/WebTest.pod Wed Oct 10 00:36:09 2012 @@ -2,14 +2,16 @@ =encoding utf8 =head1 NAME -åå + +=begin original HTTP::WebTest - Testing static and dynamic web content +=end original + HTTP::WebTest - éçåã³åçãªã¦ã§ãã³ã³ãã³ãã®ãã¹ã =head1 SYNOPSIS -æ¦è¦ use HTTP::WebTest; @@ -24,10 +26,12 @@ $webtest->run_tests($tests); =head1 DESCRIPTION -説æ =head2 Introduction -å°å ¥ + +(å°å ¥) + +=begin original This module runs tests on remote URLs containing Perl/JSP/HTML/JavaScript/etc. and generates a detailed test report. @@ -36,6 +40,8 @@ report capabilities. This module comes with a set of default plugins but can be easily extended with third party plugins. +=end original + ãã®ã¢ã¸ã¥ã¼ã«ã¯ PERL/JSP/HTML/JavaScriptçãå«ããªã¢ã¼ãURLä¸ã® ãã¹ããå®è¡ã, 詳細ãªã¬ãã¼ããçæãã¾ã. ãã®ã¢ã¸ã¥ã¼ã«ã¯ "ãã®ã¾ãã¾"使ããã¨ãã§ãã¾ã. ã¾ããã®æ©è½ããã©ã°ã¤ã³ãç¨ã㦠@@ -44,24 +50,34 @@ ãã©ã°ã¤ã³ãå«ãã§ãã¾ããç°¡åã«ãµã¼ããã¼ãã£è£½ã®ãã©ã°ã¤ã³ã§ æ¡å¼µãããã¨ãã§ãã¾ã. +=begin original + The L<wt|wt> script is provided for running C<HTTP::WebTest> from the command line. +=end original + ã³ãã³ãã©ã¤ã³ãã C<HTTP::WebTest> ãå®è¡ããããã« L<wt|wt> ã¹ã¯ãªãããæä¾ãã¦ãã¾ã. +=begin original + The test specifications can be read from a parameter file in wtscript format or input as method arguments. The test results can be displayed on the terminal, directed to a file, stored in a scalar variable. The test results can also be emailed. The report can be modified and extended using report plugins. +=end original + ãã¹ãè¦ä»¶ã¯ wtscript ãã©ã¼ãããå ã®ãã©ã¡ã¼ã¿ãã¡ã¤ã«ãã èªã¿è¾¼ã¾ãããããã¯ã¡ã½ããã®å¼æ°ã¨ãã¦æ¸¡ããããã§ã. ãã¹ãã®çµæã¯ç«¯æ«ä¸ã«è¡¨ç¤º, ãã¡ã¤ã«ã«æ¸ãè¾¼ã¿, ã¹ã«ã©ã¼å¤æ°ã« æ ¼ç´ãããã¨ãã§ãã¾ã. email ã§éããã¨ãã§ãã¾ã. ã¬ãã¼ã㯠ã¬ãã¼ããã©ã°ã¤ã³ã使ã£ã¦å¤æ´ãããæ¡å¼µãããã§ãã¾ã. +=begin original + Each URL/web file is tested by fetching it from the web server using a local instance of an HTTP user agent. The basic test is simply whether or not the fetch was successful. You may also test using @@ -71,6 +87,8 @@ page. You may also specify tests for the minimum and maximum web server response time. +=end original + å URL/ã¦ã§ããã¡ã¤ã«ã¯ HTTP ã¦ã¼ã¶ã¨ã¼ã¸ã§ã³ãã®ãã¼ã«ã«ã¤ã³ã¹ã¿ã³ã¹ ã使ã£ã¦ã¦ã§ããµã¼ãããåå¾ãã¦ãã¹ãããã¾ã. åºæ¬çãªãã¹ãã«ã¯ åç´ã«åå¾ãæåãããã©ããã¨ãããã®ãããã¾ã. ãªãã©ã«æååã @@ -79,8 +97,12 @@ ãµã¤ãºã®æå°å¤æ大å¤ã, ã¦ã§ããµã¼ãã®å¿çæéã®æå°å¤æ大å¤ã æå®ãããã¨ãã§ãã¾ã. +=begin original + Data flow for C<HTTP::WebTest>: +=end original + C<HTTP::WebTest> ã®ãã¼ã¿ã®æµãã¯ä»¥ä¸ã®æ§ã«ãªãã¾ã: -------------- ------------- @@ -100,7 +122,10 @@ ------------ =head2 Getting started -å§ãã¦ã¿ã + +(å§ãã¦ã¿ã) + +=begin original This module has complex functionality, but using it to run simple tests is simple. Create a file of test parameters in the @@ -108,6 +133,8 @@ L<wt|wt> program to process the file using the command C<wt filename>. The only required parameters are C<test_name> and C<url>. +=end original + ãã®ã¢ã¸ã¥ã¼ã«ã¯è¤éãªæ©è½ãæã£ã¦ãã¾ã. ãããç°¡åãªãã¹ããå®è¡ããã®ãªãåç´ã§ã. L<wtscript ãã©ã¼ããã|/Running HTTP::WebTest using a parameter file> 㧠@@ -115,8 +142,12 @@ ãã®ãã¡ã¤ã«ãå¦çãã¾ã. ã³ãã³ãã©ã¤ã³ã¯ C<wt filename> ã¨ãªãã¾ã. å¿ é ã®ãã©ã¡ã¼ã¿ã¯ C<test_name> 㨠C<url> ã ãã§ã. +=begin original + This document describes: +=end original + ãã®ããã¥ã¡ã³ãã§ã¯ä»¥ä¸ã®ãã¨ãè¨è¿°ãã¦ãã¾ã: =over 4 @@ -125,9 +156,13 @@ +=begin original + How tests can be specified. See section L<TEST SPECIFICATION|/TEST SPECIFICATION>. +=end original + ã©ã®ããã«ãã¹ããè¨è¿°ããã. L<ãã¹ãã®è¨è¿°æ¹æ³|/TEST SPECIFICATION> ãåç §ãã¦ãã ãã. @@ -135,21 +170,33 @@ +=begin original + All test parameters supported by core C<HTTP::WebTest> plugins. See section L<TEST PARAMETERS|/TEST PARAMETERS>. +=end original + C<HTTP::WebTest> ã³ã¢ãã©ã°ã¤ã³ã§ãµãã¼ãããã¦ããå ¨ã¦ã® ãã¹ããã©ã¡ã¼ã¿. L<ãã¹ããã©ã¡ã¼ã¿|/TEST PARAMETERS> ã åç §ãã¦ãã ãã. =back +=begin original + See L<"perldoc wt"|wt> for documentation on the wt program. +=end original + wt ããã°ã©ã ã®ããã¥ã¡ã³ã㯠L<"perldoc wt"|wt> ãåç §ãã¦ãã ãã. +=begin original + Other useful documentation is: +=end original + ä»ã«ä»¥ä¸ã®ããã¥ã¡ã³ããå½¹ã«ç«ã¤ã§ããã: =over 4 @@ -158,9 +205,13 @@ +=begin original + L<perldoc HTTP::WebTest::Cookbook|HTTP::WebTest::Cookbook> - examples of wtscript files and examples of C<HTTP::WebTest> API usage. +=end original + L<perldoc HTTP::WebTest::Cookbook|HTTP::WebTest::Cookbook> - wtscript ãã¡ã¤ã«ã®ä¾ã¨ C<HTTP::WebTest> API ã®ä½¿ãæ¹ã®ä¾. @@ -168,9 +219,13 @@ +=begin original + L<perldoc HTTP::WebTest::API|HTTP::WebTest::API> - full documentaion on API of C<HTTP::WebTest>. +=end original + L<perldoc HTTP::WebTest::API|HTTP::WebTest::API> - C<HTTP::WebTest> ã® å ¨APIã®å®å ¨ãªããã¥ã¡ã³ã. @@ -178,37 +233,55 @@ +=begin original + L<perldoc HTTP::WebTest::Plugins|HTTP::WebTest::Plugins> - for developers of C<HTTP::WebTest> plugins. +=end original + L<perldoc HTTP::WebTest::Plugins|HTTP::WebTest::Plugins> - C<HTTP::WebTest> ãã©ã°ã¤ã³ã®éçºè åã =back =head1 TEST SPECIFICATION -ãã¹ãã®è¨è¿°æ¹æ³ + +(ãã¹ãã®è¨è¿°æ¹æ³) + +=begin original The test specifications can be read from a parameter file (in the wtscript format described below) or passed as method arguments as an array of hashes. +=end original + ãã¹ãè¨è¿°ã¯(å¾è¿°ã®wpscriptãã©ã¼ãããã§æ¸ããã)ãã©ã¡ã¼ã¿ãã¡ã¤ã«ãã èªã¿è¾¼ããã¨ãã§ãã¾ã. ã¾ã, ããã·ã¥ã®é åã¨ãã¦ã¡ã½ããã®å¼æ°ã« 渡ããã¨ãã§ãã¾ã. =head2 Running HTTP::WebTest using a parameter file -ãã©ã¡ã¼ã¿ãã¡ã¤ã«ã使ã£ã¦ HTTP::WebTest ãå®è¡ãã + +(ãã©ã¡ã¼ã¿ãã¡ã¤ã«ã使ã£ã¦ HTTP::WebTest ãå®è¡ãã) + +=begin original C<HTTP::WebTest> can read test specification from file in format called as C<wtscript>. +=end original + C<HTTP::WebTest>> 㯠C<wtscript> ãã©ã¼ãããã§è¨è¿°ããããã¡ã¤ã«ãã ãã¹ãè¨è¿°ãèªã¿è¾¼ããã¨ãã§ãã¾ã. +=begin original + Tests defined by wtscript file can be run either using Perl API of C<HTTP::WebTest> +=end original + wtscript ãã¡ã¤ã«ã§å®ç¾©ããããã¹ã㯠C<HTTP::WebTest> ã® Perl API ã 使ã£ã¦å®è¡ãããã¨ãã§ãã¾ã. @@ -217,41 +290,58 @@ my $webtest = new HTTP::WebTest; $webtest->run_wtscript('script.wt'); +=begin original + or by using program L<wt|wt> supplied with this module. +=end original + ã¾ã, ãã®ã¢ã¸ã¥ã¼ã«ããæä¾ããã¦ãã L<wt|wt>ããã°ã©ã ãã å®è¡ãããã¨ãã§ãã¾ã. +=begin original + If you are running dozens of tests, you may want to divide them into several parameter files. This will organize the tests and reduce the size of the output and e-mail messages. However, cookies passed to or received from the web server(s) are not shared between tests in different parameter files. +=end original + æ°å¤ãã®ãã¹ããå®è¡ããã¨ãã«ã¯ããã¤ãã®ãã©ã¡ã¼ã¿ãã¡ã¤ã«ã«åãããã ãªãã§ããã. ããã¯ãã¹ããçµç¹åã, ããã®åºåãE-mailã¡ãã»ã¼ã¸ã 縮å°ããã¾ã. ãããã¦ã§ããµã¼ãã«éãã»åä¿¡ããã¯ããã¼ã¯ããããã® ãã©ã¡ã¼ã¿ãã¡ã¤ã«éã§å ±æããã¾ãã. =head3 File format -ãã¡ã¤ã«ãã©ã¼ããã + +(ãã¡ã¤ã«ãã©ã¼ããã) + +=begin original The wtscript file is a text file containing global parameters and test blocks containing test block parameters. A test block begins with a test_name parameter and ends with an end_test directive. The order of the parameters and test blocks is arbitrary. +=end original + wtscript ãã¡ã¤ã«ã¯ããã¹ããã¡ã¤ã«ã§ã. ã°ãã¼ãã«ãã©ã¡ã¼ã¿ã¨, ãã¹ããããã¯ãã©ã¡ã¼ã¿ã¨å«ããã¹ããããã¯ã¨ãå«ã¿ã¾ã. ãã¹ããããã¯ã¯ test_name ãã©ã¡ã¼ã¿ã§å§ã¾ã, end_test ãã£ã¬ã¯ãã£ãã§çµäºãã¾ã. ãã©ã¡ã¼ã¿ããã¹ããããã¯ã®é åºã¯ä»»æã§ã. +=begin original + Test block parameters MUST occur between a test_name parameter and an end_test directive. (Test block parameters affect only an individual test.) Global parameters must NOT occur between a test_name parameter and an end_test directive. (This requirement does not apply to certain parameters that are both global and test block parameters.) +=end original + ãã¹ããããã¯ãã©ã¡ã¼ã¿ã¯ test_name ãã©ã¡ã¼ã¿ãã end_test ãã£ã¬ã¯ãã£ã ã®éã«ããã *ãªããã°ãªãã¾ãã*. (ãã¹ããããã¯ãã©ã¡ã¼ã¿ã¯ ããã®ãã¹ãã«ã ãå½±é¿ãã¾ã.) ã°ãã¼ãã«ãã©ã¡ã¼ã¿ã¯ test_name @@ -259,8 +349,12 @@ (ãã®è¦æ±ã¯ã°ãã¼ãã«ã»ãã¹ã両ãã©ã¡ã¼ã¿ã«ãããããã¤ãã®ãã©ã¡ã¼ã¿ ã«ã¯é©ç¨ããã¾ãã.) +=begin original + The following lines are ignored: +=end original + 以ä¸ã®è¡ã¯ç¡è¦ããã¾ã: =over 4 @@ -269,37 +363,57 @@ +=begin original + lines consisting of nothing but white space (blanks or tabs) +=end original + ç½ç©ºç½(ãã©ã³ã¯ãããã¯ã¿ã)以å¤ã«ä½ãå«ã¾ãªãè¡ =item * +=begin original + lines beginning with a number sign (C<#>) +=end original + ããã·ã¥ãã¼ã¯(C<#>)ã§å§ã¾ãè¡ =item * +=begin original + lines beginning with white space (blanks or tabs) followed by a number sign +=end original + ç½ç©ºç½(ãã©ã³ã¯ãããã¯ã¿ã)ã§å§ã¾ãããã·ã¥ãã¼ã¯(C<#>)ãç¶ãè¡ =back +=begin original + Parameters are either scalar (single-valued) or lists (single-valued, multi-valued or nested). +=end original + ãã©ã¡ã¼ã¿ã¯ã¹ã«ã©ã¼(ï¼ã¤ã®å¤) ãããã¯ãªã¹ã(ï¼ã¤ã®å¤ããã㯠è¤æ°ã®å¤, ãã®ãã¹ã)ã®ã©ã¡ããã§ã. +=begin original + You can specify scalar parameters using forms such as: +=end original + ã¹ã«ã©ã¼ãã©ã¡ã¼ã¿ã¯æ¬¡ã®å½¢å¼ã§æå®ãã¾ã: name=value @@ -307,8 +421,12 @@ value name = 'value' +=begin original + You can specify list parameters using forms such as: +=end original + ãªã¹ããã©ã¡ã¼ã¿ã¯æ¬¡ã®å½¢å¼ã§æå®ãã¾ã: name = ( first value @@ -350,6 +468,8 @@ ( fourth value => fifth value ) ) +=begin original + You can specify a null (placeholder) value using '' or "". Within single or double quotes, the usual Perl string quoting rules apply. Thus, single quotes mean that all enclosed characters are interpreted @@ -361,6 +481,8 @@ at runtime. Perl variables can be defined by plugin modules or in code sections in the parameter file as described below. +=end original + '' ããã㯠"" ã使ã£ã¦ nullå¤(ãã¬ã¼ã¹ãã«ãå¤)ããããã¨ãã§ãã¾ã. ã·ã³ã°ã«ã¯ãªã¼ããããã«ã¯ãªã¼ããã®éã㯠Perl ã®ããã¨åãã§ã. ã¤ã¾ãã·ã³ã°ã«ã¯ãªã¼ãã¯æåéãã«è§£éããã¾ã. '\n' ã¯æ¹è¡æåã§ã¯ @@ -372,6 +494,8 @@ Perl å¤æ°ã¯ãã©ã°ã¤ã³ã¢ã¸ã¥ã¼ã«ããã©ã¡ã¼ã¿ãã¡ã¤ã«ã®ã³ã¼ãã»ã¯ã·ã§ã³ (å¾è¿°)ã§å®ç¾©ãããã¨ãã§ãã¾ã. +=begin original + It is also possible to specify a Perl expression in place of a scalar value, one of a list parameter's values or an entire list. Curly brackets are used to denote Perl code inside wtscript files. @@ -380,6 +504,8 @@ required. When these subroutines are called C<HTTP::WebTest> object is passed to them as the first argument. +=end original + ã¹ã«ã©ã¼å¤, ãªã¹ããã©ã¡ã¼ã¿ã®ï¼ã¤, ãããã¯ãªã¹ããã®ãã®ãç½®ãå ´æã«ã¯ Perl ã®å¼ãç½®ããã¨ãã§ãã¾ã. wpscriptãã¡ã¤ã«ã«ããã¦, Perl ã®ã³ã¼ãã¨è©ä¾¡ãããç®æã«ã¯ã«ã¼ã«ããæ¬å¼§ã使ãã¾ã. @@ -412,7 +538,10 @@ name = { my $webtest = shift; ..... } =head3 Examples of wtscript files -wtscript ãã¡ã¤ã«ã®ä¾ + +(wtscript ãã¡ã¤ã«ã®ä¾) + +=begin original The parameters below specify tests. The tests specified by the C<text_forbid> parameter apply to both the "MyCompany home page" and @@ -421,6 +550,8 @@ If any test fails or the fetch of the URL fails, an e-mail will be sent to teste****@mycom*****. +=end original + 以ä¸ã®ãã©ã¡ã¼ã¿ã¯ãã¹ããè¨è¿°ãã¦ãã¾ã. C<test_forbid> ãã©ã¡ã¼ã¿ã§æå®ããããã¹ã㯠"MyCompany home page" åã³ "Yahoo home page" ãã¹ã両æ¹ã«é©ç¨ããã¾ã. @@ -456,37 +587,54 @@ end_test =head2 Calling HTTP::WebTest from a Perl program -Perl ããã°ã©ã ãã HTTP::WebTest ã使ã + +(Perl ããã°ã©ã ãã HTTP::WebTest ã使ã) + +=begin original If you are using the Perl API of C<HTTP::WebTest>, the test parameters can be defined as an array of hashes. +=end original + C<<HTTP::WebTest> ã® Perl API ã使ãã¨ãã¯, ãã¹ããã©ã¡ã¼ã¿ã¯ ããã·ã¥ã®é åã®å½¢ã§å®ç¾©ãã¾ã. +=begin original + Each hash in the array defines tests for one URL. Keys in the hashes are test parameter names and values in hashes are values of test parameters. Optional global test parameters can be passed in a hash passed as the second argument. +=end original + é åå ã®æ ¸ããã·ã¥ãï¼ã¤ã®URLã«å¯¾ãããã¹ãã¨ãªãã¾ã. ããã·ã¥ã®ãã¼ããã¹ããã©ã¡ã¼ã¿ã®ååã«ãªã, ããã·ã¥ã®å¤ã ãã¹ããã©ã¡ã¼ã¿ã®å¤ã«ãªãã¾ã. ã°ãã¼ãã«ãã¹ããã©ã¡ã¼ã¿ã使ã æã¯, ï¼çªç®ã®å¼æ°ã«ããã·ã¥ãªãã¡ã¬ã³ã¹ã¨ãã¦æ¸¡ãã¾ã. +=begin original + Subroutine references can be specified instead of test parameter values. Referenced subroutines are called during test run when values of corresponding test parameters are required. These subroutines are called in an object-oriented fashion, so the C<HTTP::WebTest> object is passed as the first argument. +=end original + ãã©ã¡ã¼ã¿ã®å¤ã¨ãã¦é¢æ°ã®ãªãã¡ã¬ã³ã¹ã使ããã¨ãã§ãã¾ã. é¢æ°ã¯ãã¹ããã©ã¡ã¼ã¿ã®å¤ãå¿ è¦ã¨ãããã¨ãã«å¼ã³åºããã¾ã. é¢æ°ã¯ãªãã¸ã§ã¯ãæåçã«å¼ã³åºãã, C<HTTP::WebTest> ãªãã¸ã§ã¯ãã ï¼ã¤ç®ã®å¼æ°ã¨ãã¦æ¸¡ããã¾ã. +=begin original + Tests can be run as +=end original + ãã¹ãã¯æ¬¡ã®ããã«å®è¡ãã¾ã. use HTTP::WebTest; @@ -505,11 +653,16 @@ ); =head3 Example -ä¾ + +(ä¾) + +=begin original This Perl script tests Yahoo home page and sends full test report to C<teste****@mycom*****>. +=end original + 以ä¸ã® Perl ã¹ã¯ãªããã§ã¯ Yahoo ãã¼ã ãã¼ã¸ããã¹ãã㦠ãã®å®å ¨ãªãã¹ãçµæã C<teste****@mycom*****> ã«éãã¾ã. @@ -534,16 +687,22 @@ $webtest->run_tests($tests, $params); =head1 PLUGIN MODULES -ãã©ã°ã¤ã³ã¢ã¸ã¥ã¼ã« + +(ãã©ã°ã¤ã³ã¢ã¸ã¥ã¼ã«) =head2 Core plugin modules -ã³ã¢ãã©ã°ã¤ã³ã¢ã¸ã¥ã¼ã« + +(ã³ã¢ãã©ã°ã¤ã³ã¢ã¸ã¥ã¼ã«) + +=begin original C<HTTP::WebTest> is implemented in a modular structure that allows programmers to easily add modules to run additional tests or define additional simple tests without writing a module. C<HTTP::WebTest> provides a number of core plugin modules which are loaded by default: +=end original + C<HTTP::WebTest> ã¢ã¸ã¥ã¼ã«æ§é ãç¨ãã¦å®è£ ããã¦ãã¾ã. ããã«ããããã°ã©ããç°¡åã«æ°ãããã¹ããå®è¡ããã¢ã¸ã¥ã¼ã«ã追å ããã, ã¢ã¸ã¥ã¼ã«ãæ¸ããã¨ããã¹ãã追å å®ç¾©ãããã¨ãã§ãã¾ã. @@ -554,69 +713,110 @@ =item L<HTTP::WebTest::Plugin::ContentSizeTest|HTTP::WebTest::Plugin::ContentSizeTest> +=begin original + This plugin checks the size of the fetched web page. +=end original + ãã®ãã©ã°ã¤ã³ã¯åå¾ããã¦ã§ããã¼ã¸ã®ãµã¤ãºã調ã¹ã¾ã. =item L<HTTP::WebTest::Plugin::Cookies|HTTP::WebTest::Plugin::Cookies> +=begin original + This plugin controls sending and receiving cookies. +=end original + ãã®ãã©ã°ã¤ã³ã¯ã¯ããã¼ã®éåä¿¡ãå¶å¾¡ãã¾ã. =item L<HTTP::WebTest::Plugin::DefaultReport|HTTP::WebTest::Plugin::DefaultReport> +=begin original + This plugin manages the test report. +=end original + ãã®ãã©ã°ã¤ã³ã¯ãã¹ãã¬ãã¼ãã管çãã¾ã. =item L<HTTP::WebTest::Plugin::Loader|HTTP::WebTest::Plugin::Loader> +=begin original + This plugin supports adding external plugin modules. +=end original + ãã®ãã©ã°ã¤ã³ã¯å¤é¨ãã©ã°ã¤ã³ã¢ã¸ã¥ã¼ã«ã®è¿½å ãè£å©ãã¾ã. =item L<HTTP::WebTest::Plugin::ResponseTimeTest|HTTP::WebTest::Plugin::ResponseTimeTest> +=begin original + This plugin tests the response times of the web server. +=end original + ãã®ãã©ã°ã¤ã³ã¯ã¦ã§ããµã¼ãã®å¿çæéã調ã¹ã¾ã. =item L<HTTP::WebTest::Plugin::SetRequest|HTTP::WebTest::Plugin::SetRequest> +=begin original + This plugin initializes the HTTP requests. +=end original + ãã®ãã©ã°ã¤ã³ã¯ HTTP ãªã¯ã¨ã¹ãã®åæåãè¡ãã¾ã. =item L<HTTP::WebTest::Plugin::StatusTest|HTTP::WebTest::Plugin::StatusTest> +=begin original + This plugin checks the status of the HTTP responses. +=end original + ãã®ãã©ã°ã¤ã³ã¯ HTTP ã¬ã¹ãã³ã¹ã®ã¹ãã¼ã¿ã¹ã調ã¹ã¾ã. =item L<HTTP::WebTest::Plugin::TextMatchTest|HTTP::WebTest::Plugin::TextMatchTest> +=begin original + This plugin tests whether the content of the HTTP response matches or doesn't match selected text or regular expressions. +=end original + ãã®ãã©ã°ã¤ã³ã¯ HTTP ã¬ã¹ãã³ã¹ã®å 容ãæå®ããããã¹ãã¾ã㯠æ£è¦è¡¨ç¾ãå«ãã, ãããã¯å«ã¾ãªããã調ã¹ã¾ã. =back +=begin original + Information about test parameters supported by core plugins is summarized below in the section L<TEST PARAMETERS|/TEST PARAMETERS>. +=end original + ã³ã¢ãã©ã°ã¤ã³ããµãã¼ããã¦ãããã©ã¡ã¼ã¿ã«é¢ããæ å ±ã¯, å¾è¿°ã® L<ãã¹ããã©ã¡ã¼ã¿|/TEST PARAMETERS> ã»ã¯ã·ã§ã³ã«è¦ç´ãããã¾ã. =head2 Other plugin modules bundled with HTTP::WebTest -HTTP::WebTest ã«ä»å±ãããã®ä»ã®ãã©ã°ã¤ã³ã¢ã¸ã¥ã¼ã« + +(HTTP::WebTest ã«ä»å±ãããã®ä»ã®ãã©ã°ã¤ã³ã¢ã¸ã¥ã¼ã«) + +=begin original Following plugin modules come with HTTP::WebTest but they are not loaded by default. To use such plugin module load it using global test parameter C<plugins>. +=end original + HTTP::WebTest ã«ã¯ä»¥ä¸ã®ã¢ã¸ã¥ã¼ã«ãä»å±ãã¦ãã¾ã. ããã ãããã¯ããã©ã«ãã§ã¯ãã¼ãããã¾ãã. ãããã®ãã©ã°ã¤ã³ã¢ã¸ã¥ã¼ã«ã 使ãã¨ãã«ã¯ã°ãã¼ãã«ãã¹ããã©ã¡ã¼ã¿ C<plugins> ã使ã£ã¦ãã ãã. @@ -625,95 +825,146 @@ =item L<HTTP::WebTest::Plugin::Click|HTTP::WebTest::Plugin::Click> +=begin original + This plugin supports using names of links and buttons on HTML pages to build additional tests. +=end original + ãã®ãã©ã°ã¤ã³ã¯è¿½å ãã¹ããä½ãããã« HTML ãã¼ã¸ã®ãªã³ã¯ããã¿ã³ã®åå㮠使ç¨ãæä¾ãã¾ã. =item L<HTTP::WebTest::Plugin::Delay|HTTP::WebTest::Plugin::Delay> +=begin original + This plugin module allows the user to specify pauses in the test sequence. +=end original + ãã®ãã©ã°ã¤ã³ã¯ãã¹ãã®æµããä¸æçã«åæ¢ããããã¨ãã§ãã¾ã. =item L<HTTP::WebTest::Plugin::HarnessReport|HTTP::WebTest::Plugin::HarnessReport> +=begin original + This report plugin can generate test reports that are compatible with L<Test::Harness|Test::Harness>. +=end original + ãã®ã¬ãã¼ããã©ã°ã¤ã³ã¯ L<Test::Harness|Test::Harness> äºæã® ã¬ãã¼ããçæãã¾ã. =item L<HTTP::WebTest::Plugin::Hooks|HTTP::WebTest::Plugin::Hooks> +=begin original + This plugin allows the user to define callback parameters that are evaluated at runtime. This allows the user to define additional tests without writing a plugin module. +=end original + ãã®ãã©ã°ã¤ã³ã¯å®è¡æã«è©ä¾¡ãããã³ã¼ã«ããã¯ãã©ã¡ã¼ã¿ãå®ç¾©ãã¾ã. ããã«ãããã©ã°ã¤ã³ã¢ã¸ã¥ã¼ã«ãæ¸ããã¨ãªãã«æ°ãããã¹ããå®ç¾©ãããã¨ã ã§ãã¾ã. =back +=begin original + Information about test parameters supported by add-on plugin modules is summarized below in section L<TEST PARAMETERS|/TEST PARAMETERS>. +=end original + ã¢ãã¤ã³ãã©ã°ã¤ã³ããµãã¼ããã¦ãããã©ã¡ã¼ã¿ã«é¢ããæ å ±ã¯, å¾è¿°ã® L<ãã¹ããã©ã¡ã¼ã¿|/TEST PARAMETERS> ã»ã¯ã·ã§ã³ã«è¦ç´ãããã¾ã. =head2 Plugin modules released separately from HTTP::WebTest -HTTP::WebTest ã¨ã¯å¥ã«ãªãªã¼ã¹ããã¦ãããã©ã°ã¤ã³ã¢ã¸ã¥ã¼ã« + +(HTTP::WebTest ã¨ã¯å¥ã«ãªãªã¼ã¹ããã¦ãããã©ã°ã¤ã³ã¢ã¸ã¥ã¼ã«) + +=begin original Following additional C<HTTP::WebTest> plugins are avialable separately from CPAN. +=end original + 以ä¸ã® C<HTTP::WebTest> ãã©ã°ã¤ã³ã¯å¥åã« CPAN ã§æä¾ããã¦ãã¾ã. =over 4 =item L<HTTP::WebTest::Plugin::Apache|HTTP::WebTest::Plugin::Apache> +=begin original + This plugin supports testing web files using a local instance of Apache. +=end original + ãã®ãã©ã°ã¤ã³ã¯ Apache ã®ãã¼ã«ã«ã¤ã³ã¹ã¿ã³ã¹ã使ã£ã¦ã¦ã§ããã¡ã¤ã«ã 調ã¹ã¾ã. =item L<HTTP::WebTest::Plugin::TagAttTest|HTTP::WebTest::Plugin::TagAttTest> +=begin original + This plugin allows to forbid or require tags and/or attributes in a web page. +=end original + ãã®ãã©ã°ã¤ã³ã¯ã¦ã§ããã¼ã¸å ã®ã¿ã°ãå±æ§ãç¦æ¢ã»è¦æ±ã§ãã¾ã. =item L<HTTP::WebTest::Plugin::DateTest|HTTP::WebTest::Plugin::DateTest> +=begin original + Evaluate the "age" of embedded date strings in response body. +=end original + ã¬ã¹ãã³ã¹æ¬ä½ã®æ¥ä»æååã«åãè¾¼ã¾ãã "å¹´é½¢" ãè©ä¾¡ãã¾ã. =item L<HTTP::WebTest::Plugin::XMLReport|HTTP::WebTest::Plugin::XMLReport> +=begin original + Report plugin for HTTP::WebTest, generates output in XML format. +=end original + XML å½¢å¼ã§åºåããã¬ãã¼ããã©ã°ã¤ã³ã§ã. =back =head2 Writing plugin modules -ãã©ã°ã¤ã³ã¢ã¸ã¥ã¼ã«ãæ¸ãã«ã¯ + +(ãã©ã°ã¤ã³ã¢ã¸ã¥ã¼ã«ãæ¸ãã«ã¯) + +=begin original See L<perldoc HTTP::WebTest::Plugins|HTTP::WebTest::Plugins> for information about writing L<HTTP::WebTest|HTTP::WebTest> plugin modules. +=end original + L<HTTP::WebTest|HTTP::WebTest> ãã©ã°ã¤ã³ã¢ã¸ã¥ã¼ã«ãæ¸ãããã®æ å ±ã¯, L<perldoc HTTP::WebTest::Plugins|HTTP::WebTest::Plugins> ãåç §ãã¦ãã ãã. =head1 ADD-ONS -ã¢ããªã³ + +(ã¢ããªã³) + +=begin original Besides L<additional plugins|/Plugin modules released separately from HTTP::WebTest> other L<HTTP::WebTest|HTTP::WebTest> add-ons are available from CPAN: +=end original + L<追å ãã©ã°ã¤ã³|/Plugin modules released separately from HTTP::WebTest> 以å¤ã«ã, ä»ã® L<HTTP::WebTest|HTTP::WebTest> ã¢ããªã³ã CPAN 㧠æä¾ããã¦ãã¾ã: @@ -722,14 +973,21 @@ =item L<HTTP::WebTest::XMLParser|HTTP::WebTest::XMLParser> +=begin original + Parser of XML representation of wtscript. +=end original + XML ã§æ¸ããã wtcript ã®ãã¼ãµã¼. =back =head1 TEST PARAMETERS -ãã¹ããã©ã¡ã¼ã¿ + +(ãã¹ããã©ã¡ã¼ã¿) + +=begin original Most parameters can be used as both global and test block parameters. If you specify such parameter outside a test block, that value @@ -737,61 +995,89 @@ overriden in each test block by specifying the parameter within the test block. +=end original + 大æµã®ãã¹ããã©ã¡ã¼ã¿ã¯ã°ãã¼ãã«ã§ããã¹ããããã¯ã§ã使ããã¨ãã§ãã¾ã. ãã¹ããããã¯ã®å¤ã§æå®ãããã©ã¡ã¼ã¿ã¯å ¨ã¦ã®ãã¹ããããã¯ã®ããã©ã«ãå¤ ã«ãªãã¾ã. ãã¹ããããã¯ã§æå®ãããã©ã¡ã¼ã¿ã¯ã°ãã¼ãã«å¤ãä¸æ¸ããã¾ã. +=begin original + Parameters marked as I<GLOBAL PARAMETER> can be used only as global and cannot be overriden in test blocks. +=end original + I<GLOBAL PARAMETER> ã¨ãã¼ã¯ããã¦ãããã©ã¡ã¼ã¿ã¯ã°ãã¼ãã« ãã©ã¡ã¼ã¿ã¨ãã¦ã®ã¿ä½¿ãã¾ã. ãã¹ããããã¯ã§ã®ä¸æ¸ãã¯ã§ãã¾ãã. +=begin original + Parameters marked as I<NON-CORE PARAMETER> are defined in add-on plugin modules which must be loaded explicitly using the parameter C<plugins>. +=end original + I<NON-CORE PARAMETER> ã¨ãã¼ã¯ããã¦ãããã©ã¡ã¼ã¿ã¯ã¢ããªã³ãã©ã°ã¤ã³ ã¢ã¸ã¥ã¼ã«ã§å®ç¾©ããããã®ã§ã. ããã㯠C<plugins> ãã©ã¡ã¼ã¿ã§ æ示çã«ãã¼ãããªããã°ãªãã¾ãã. =head2 accept_cookies +=begin original + Option to accept cookies from the web server. +=end original + ã¦ã§ããµã¼ãããã¯ããã¼ãåãã¤ãããã®è¨å®. +=begin original + These cookies exist only while the program is executing and do not affect subsequent runs. These cookies do not affect your browser or any software other than the test program. These cookies are only accessible to other tests executed during test sequence execution. +=end original + ã¯ããã¼ã¯ããã°ã©ã ã®å®è¡ä¸ã«ã ãåå¨ã, ãã以éã¯å½±é¿ãä¸ãã¾ãã. ãããã®ã¯ããã¼ã¯ããªãã®ãã©ã¦ã¶ããã¹ãããã°ã©ã 以å¤ã®ã½ããã¦ã§ã¢ ã«ã¯å½±é¿ãã¾ãã. ã¯ããã¼ã¯ï¼ã¤ã®ãã¹ãã·ã¼ã±ã³ã¹ä¸ã§å®è¡ãã¦ãã ä»ã®ãã¹ãããã ãã¢ã¯ã»ã¹ã§ãã¾ã. +=begin original + See also the <send_cookies> parameter. +=end original + <send_cookies> ãã©ã¡ã¼ã¿ãåç §ãã¦ãã ãã. =head3 Allowed values -使ç¨å¯è½ãªå¤ + +(使ç¨å¯è½ãªå¤) C<yes>, C<no> =head3 Default value -ããã©ã«ãå¤ + +(ããã©ã«ãå¤) C<yes> =head2 auth +=begin original + A list which contains two elements: userid/password pair to be used for web page access authorization. +=end original + ã¦ã§ããã¼ã¸ã¸ã®ã¢ã¯ã»ã¹èªè¨¼ã«ä½¿ãã¦ã¼ã¶å/ãã¹ã¯ã¼ãã®ï¼ã¤ã®è¦ç´ ãã㤠ãªã¹ããæå®ãã¾ã. @@ -800,25 +1086,38 @@ I<NON-CORE PARAMETER> from L<HTTP::WebTest::Plugin::Click> +=begin original + Given name of submit button (i.e. C<<input type="submit"E<gt>> tag or C<<input type="image"E<gt>> inside of C<<formE<gt>> tag) on previously requested HTML page, builds test request to the submitted page. +=end original + åã«è¦æ±ãã HTML ãã¼ã¸ã®ãµãããããã¿ã³ã®åå(ã¤ã¾ã C<<formE<gt>> å ã® C<<input type="submit"E<gt>> ã¿ã°ã C<<input type="image"E<gt>>)ã ä¸ãããã¨ã§, ãµããããå ã®ãã¼ã¸ã¸ã®ãã¹ããªã¯ã¨ã¹ããä½ãã¾ã. +=begin original + Note that you still need to pass all form parameters yourself using C<params> test parameter. +=end original + ãã®ãã©ã¡ã¼ã¿ã使ã£ã¦ã, C<params> ãã¹ããã©ã¡ã¼ã¿ã§å ¨ã¦ã® ãã©ã¡ã¼ã¿ãæå®ããªããã°ãªããªããã¨ã«æ³¨æãã¦ãã ãã. =head3 Example -ä¾ + +(ä¾) + +=begin original See example in L<HTTP::WebTest::Cookbook|HTTP::WebTest::Cookbook>. +=end original + L<HTTP::WebTest::Cookbook|HTTP::WebTest::Cookbook> ã«ããä¾ã åç §ãã¦ãã ãã. @@ -827,37 +1126,58 @@ I<NON-CORE PARAMETER> from L<HTTP::WebTest::Plugin::Click> +=begin original + Given name of link (i.e. C<<aE<gt>> tag) on previosly requested HTML page, builds test request to the linked page. +=end original + åã«è¦æ±ãã HTML ãã¼ã¸ã®ãªã³ã¯ã®åå(ã¤ã¾ã C<<aE<gt>> ã¿ã°)ã ä¸ãããã¨ã§, ãµããããå ã®ãã¼ã¸ã¸ã®ãã¹ããªã¯ã¨ã¹ããä½ãã¾ã. =head3 Example -ä¾ + +(ä¾) + +=begin original See example in L<HTTP::WebTest::Cookbook|HTTP::WebTest::Cookbook>. +=end original + L<HTTP::WebTest::Cookbook|HTTP::WebTest::Cookbook> ã«ããä¾ã åç §ãã¦ãã ãã. =head2 cookie +=begin original + Synonym to C<cookies>. +=end original + C<cookies> ã®å義èªã§ã. +=begin original + It is deprecated parameter and may be removed in future versions of L<HTTP::WebTest|HTTP::WebTest>. +=end original + ãã®ãã©ã¡ã¼ã¿ã¯å»æ¢ããã¦ãã¾ã. ä»å¾ã®ãã¼ã¸ã§ã³ã® L<HTTP::WebTest|HTTP::WebTest> ã§åé¤ãããã§ããã. =head2 cookies +=begin original + This is a list parameter that specifies cookies to send to the web server: +=end original + ã¦ã§ããµã¼ãã«éãã¯ããã¼ãæå®ãããªã¹ããæå®ãã¾ã: cookies = ( cookie1_spec @@ -865,8 +1185,12 @@ ... cookieN_spec ) +=begin original + Currently there are two ways to specify a cookie. +=end original + ç¾å¨ã®ã¨ããï¼ç¨®é¡ã®è¨è¿°æ¹æ³ãããã¾ã. =over 4 @@ -875,8 +1199,12 @@ * ååä»ãã¹ã¿ã¤ã« +=begin original + A cookie is specified by a set of C<param =E<gt> value> pairs: +=end original + ã¯ããã¼ã¯ C<param =E<gt> value> ãã¢ã®éåã§æå®ãã¾ã: ( @@ -884,53 +1212,81 @@ ... ) +=begin original + List of all supported C<param =E<gt> value> pairs: +=end original + ãµãã¼ãããã¦ãã C<param =E<gt> value> ãã¢ã¯ä»¥ä¸ã®éãã§ã: =over 4 =item version => VERSION +=begin original + Version number of cookie spec to use, usually 0. +=end original + 使ç¨ããã¯ããã¼æå®æ¹æ³ã®ãã¼ã¸ã§ã³çªå·. é常㯠0 ãæå®ãã¾ã. =item name => NAME (REQUIRED) +=begin original + name of cookie. cannot begin with a $ character. +=end original + ã¯ããã¼ã®åå. æå $ ã§å§ã¾ãååã¯ä½¿ãã¾ãã. =item value => VALUE (REQUIRED) +=begin original + Value of cookie. +=end original + ã¯ããã¼ã®å¤. =item path => PATH (REQUIRED) +=begin original + url path name for which this cookie applies. must begin with a / character. see also path_spec. +=end original + ãã®ã¯ããã¼ãé©ç¨ããã url ãã¹. æå / ã§å§ã¾ããªããã°ãªãã¾ãã. path_spec ãåç §ãã¦ãã ãã. =item domain => DOMAIN (REQUIRED) +=begin original + Domain for which cookie is valid. Must either contain two periods or be equal to C<.local>. +=end original + ã¯ããã¼ãæå¹ã«ãããã¡ã¤ã³. ï¼ã¤ã®ããªãªããå«ãã C<.local> 㨠çãããªããã°ãªãã¾ãã. =item port => PORT +=begin original + List of allowed port numbers that the cookie may be returned to. If not specified, cookie can be returned to any port. Must be specified using the format C<N> or C<N, N, ..., N> where N is one or more digits. +=end original + ã¯ããã¼ãè¿ããã¨ã許å¯ãããã¼ãçªå·ã®ãªã¹ã. æå®ããªããã°å ¨ã¦ã®ãã¼ãã«å¯¾ãã¦è¿ãããã«ãªãã¾ã. C<N> ããã㯠C<N, N, ..., N> ã¨ãããã©ã¼ããããã¦æå®ãã¦ãã ãã @@ -938,9 +1294,13 @@ =item path_spec => PATH_SPEC +=begin original + Ignored if version is less than 1. Option to ignore the value of path. Default value is 0. +=end original + version ã 1 ããå°ããã¨ãã¯ç¡è¦ããã¾ã. path ã®å¤ãç¡è¦ãããã©ãããè¨å®ãã¾ã. ããã©ã«ã㯠0 ã§ã. @@ -948,23 +1308,35 @@ =item * 1 +=begin original + Use the value of path. +=end original + path ã®å¤ã使ã. =item * 0 +=begin original + Ignore the specified value of path. +=end original + path ã«æå®ãããå¤ãç¡è¦ãã. =back =item secure => SECURE +=begin original + Option to require secure protocols for cookie transmission. Default value is 0. +=end original + ã¯ããã¼ã®è»¢éã«ã»ãã¥ã¢ãªãããã³ã«ãè¦æ±ãã. ããã©ã«ã㯠0. @@ -972,30 +1344,46 @@ =item * 1 +=begin original + Use only secure protocols to transmit this cookie. +=end original + ãã®ã¯ããã¼ã¯ã»ãã¥ã¢ãªãããã³ã«ã§ã®ã¿ä½¿ããã. =item * 0 +=begin original + Secure protocols are not required for transmission. +=end original + 転éæã«ã»ãã¥ã¢ãªãããã³ã«ãå¿ è¦ã¨ããªã. =back =item maxage => MAXAGE +=begin original + Number of seconds until cookie expires. +=end original + ã¯ããã¼ãæéåãã¨ãªãã¾ã§ã®ç§æ°. =item discard => DISCARD +=begin original + Option to discard cookie when the program finishes. Default is 0. (The cookie will be discarded regardless of the value of this element.) +=end original + ããã°ã©ã ãçµäºããã¨ãã«ã¯ããã¼ãç ´æ£ãããã®è¨å®. ããã©ã«ã㯠0. (ã¯ããã¼ã¯ãã®è¦ç´ ã®å¤ã«é¢ãããç ´æ£ããã¾ã.) @@ -1004,36 +1392,56 @@ =item * 1 +=begin original + Discard cookie when the program finishes. +=end original + ããã°ã©ã çµäºæã«ã¯ããã¼ãç ´æ£ãã. =item * 0 +=begin original + Don't discard cookie. +=end original + ã¯ããã¼ãç ´æ£ããªã. =back =item rest => NAME_VALUE_LIST +=begin original + Defines additional cookie attributes. +=end original + ã¯ããã¼ã®å±æ§ã追å å®ç¾©ãã. +=begin original + Zero, one or several name/value pairs may be specified. The name parameters are words such as Comment or CommentURL and the value parameters are strings that may contain embedded blanks. +=end original + 0å, 1å, ãã以ä¸ã®åå/å¤ãã¢ãæå®ãã¾ã. åå㯠Comment ã CommentURL ã¨ãã£ãåèªã, å¤ã«ã¯æåå(空ç½ã å«ããã¨ãã§ãã¾ã)ãæå®ãã¾ã. =back +=begin original + Example (wtscript file): +=end original + ä¾ (wtscript ãã¡ã¤ã«): cookies = ( ( name => Cookie1 @@ -1048,8 +1456,12 @@ value => cookie value rest => ( Comment => this is a comment ) ) +=begin original + Example (Perl script): +=end original + ä¾ (Perl ã¹ã¯ãªãã): my $tests = [ @@ -1074,14 +1486,22 @@ * è¡ãªã¹ãã¹ã¿ã¤ã« +=begin original + This style of cookie specification is deprecated and may be removed in future versions of L<HTTP::WebTest|HTTP::WebTest>. +=end original + ãã®å½¢å¼ã§ã®æå®ã¯å»æ¢ããã¦ãã¾ã. ä»å¾ã®ãã¼ã¸ã§ã³ã® L<HTTP::WebTest|HTTP::WebTest> ã§åé¤ãããã§ããã. +=begin original + Each cookie is specified by following list: +=end original + åã¯ããã¼ã¯ä»¥ä¸ã®ãªã¹ãã®å½¢ã§æå®ããã¾ã: ( VERSION @@ -1101,9 +1521,13 @@ ... ) +=begin original + Any element not marked below as REQUIRED may be defaulted by specifying a null value or ''. +=end original + 以ä¸ã§ REQUIRED ã¨ãã¼ã¯ããã¦ããè¦ç´ ã¯nullå¤ããã㯠'' ãããã©ã«ãã«ãªãã¾ã. @@ -1111,45 +1535,69 @@ =item * VERSION (REQUIRED) +=begin original + Version number of cookie spec to use, usually 0. +=end original + 使ç¨ããã¯ããã¼æå®æ¹æ³ã®ãã¼ã¸ã§ã³çªå·. é常㯠0 ãæå®ãã¾ã. =item * NAME (REQUIRED) +=begin original + Name of cookie. Cannot begin with a $ character. +=end original + ã¯ããã¼ã®åå. æå $ ã§å§ã¾ãååã¯ä½¿ãã¾ãã. =item * VALUE (REQUIRED) +=begin original + Value of cookie. +=end original + ã¯ããã¼ã®å¤. =item * PATH (REQUIRED) +=begin original + URL path name for which this cookie applies. Must begin with a / character. See also path_spec. +=end original + ãã®ã¯ããã¼ãé©ç¨ããã url ãã¹. æå / ã§å§ã¾ããªããã°ãªãã¾ãã. path_spec ãåç §ãã¦ãã ãã. =item * DOMAIN (REQUIRED) +=begin original + Domain for which cookie is valid. Must either contain two periods or be equal to C<.local>. +=end original + ã¯ããã¼ãæå¹ã«ãããã¡ã¤ã³. ï¼ã¤ã®ããªãªããå«ãã C<.local> 㨠çãããªããã°ãªãã¾ãã. =item * PORT +=begin original + List of allowed port numbers that the cookie may be returned to. If not specified, cookie can be returned to any port. Must be specified using the format C<N> or C<N, N, ..., N> where N is one or more digits. +=end original + ã¯ããã¼ãè¿ããã¨ã許å¯ãããã¼ãçªå·ã®ãªã¹ã. æå®ããªããã°å ¨ã¦ã®ãã¼ãã«å¯¾ãã¦è¿ãããã«ãªãã¾ã. C<N> ããã㯠C<N, N, ..., N> ã¨ãããã©ã¼ããããã¦æå®ãã¦ãã ãã @@ -1157,9 +1605,13 @@ =item * PATH_SPEC +=begin original + Ignored if version is less than 1. Option to ignore the value of path. Default value is 0. +=end original + version ã 1 ããå°ããã¨ãã¯ç¡è¦ããã¾ã. path ã®å¤ãç¡è¦ãããã©ãããè¨å®ãã¾ã. ããã©ã«ã㯠0 ã§ã. @@ -1167,23 +1619,35 @@ =item * 1 +=begin original + Use the value of path. +=end original + path ã®å¤ã使ã. =item * 0 +=begin original + Ignore the specified value of path. +=end original + path ã«æå®ãããå¤ãç¡è¦ãã. =back =item * SECURE +=begin original + Option to require secure protocols for cookie transmission. Default value is 0. +=end original + ã¯ããã¼ã®è»¢éã«ã»ãã¥ã¢ãªãããã³ã«ãè¦æ±ãã. ããã©ã«ã㯠0. @@ -1191,30 +1655,46 @@ =item * 1 +=begin original + Use only secure protocols to transmit this cookie. +=end original + ãã®ã¯ããã¼ã¯ã»ãã¥ã¢ãªãããã³ã«ã§ã®ã¿ä½¿ããã. =item * 0 +=begin original + Secure protocols are not required for transmission. +=end original + 転éæã«ã»ãã¥ã¢ãªãããã³ã«ãå¿ è¦ã¨ããªã. =back =item * MAXAGE +=begin original + Number of seconds until cookie expires. +=end original + ã¯ããã¼ãæéåãã¨ãªãã¾ã§ã®ç§æ°. =item * DISCARD +=begin original + Option to discard cookie when the program finishes. Default is 0. (The cookie will be discarded regardless of the value of this element.) +=end original + ããã°ã©ã ãçµäºããã¨ãã«ã¯ããã¼ãç ´æ£ãããã®è¨å®. ããã©ã«ã㯠0. (ã¯ããã¼ã¯ãã®è¦ç´ ã®å¤ã«é¢ãããç ´æ£ããã¾ã.) @@ -1223,32 +1703,48 @@ =item * 1 +=begin original + Discard cookie when the program finishes. +=end original + ããã°ã©ã çµäºæã«ã¯ããã¼ãç ´æ£ãã. =item * 0 +=begin original + Don't discard cookie. +=end original + ã¯ããã¼ãç ´æ£ããªã. =back =item * name/value +=begin original + Zero, one or several name/value pairs may be specified. The name parameters are words such as Comment or CommentURL and the value parameters are strings that may contain embedded blanks. +=end original + 0å, 1å, ãã以ä¸ã®åå/å¤ãã¢ãæå®ãã¾ã. åå㯠Comment ã CommentURL ã¨ãã£ãåèªã, å¤ã«ã¯æåå(空ç½ã å«ããã¨ãã§ãã¾ã)ãæå®ãã¾ã. =back +=begin original + An example cookie would look like: +=end original + ä¾ãã°æ¬¡ã®ããã«ãªãã¾ã: cookies = ( ( 0 @@ -1265,8 +1761,12 @@ =back +=begin original + See RFC 2965 for details (ftp://ftp.isi.edu/in-notes/rfc2965.txt). +=end original + 詳細㯠RFC 2965 (ftp://ftp.isi.edu/in-notes/rfc2965.txt) ã åç §ãã¦ãã ãã. @@ -1275,6 +1775,8 @@ I<GLOBAL PARAMETER> +=begin original + This parameter controls whether the default report plugin is used for test report creation. Value C<yes> means that default report plugin will be used, value C<no> means that it will not. @@ -1282,6 +1784,8 @@ (i.e. if this parameter has value C<no> and no other report plugins are loaded). +=end original + ãã®ãã©ã¡ã¼ã¿ã§ã¯ããã©ã«ãã¬ãã¼ããã©ã°ã¤ã³ã使ã£ã¦ãã¹ãã¬ãã¼ãã çæãããã©ãããå¶å¾¡ãã¾ã. å¤ C<yes> ã¯ããã©ã«ãã¬ãã¼ããã©ã°ã¤ã³ ã®ä½¿ç¨ãæå³ãã¾ã. å¤ C<no> ã®ã¨æ°ã¯ä½¿ç¨ãã¾ãã. @@ -1290,13 +1794,15 @@ ããªãã£ãã¨ã). =head3 Allowed values -使ç¨å¯è½ãªå¤ + +(使ç¨å¯è½ãªå¤) C<yes>, C<no> =head3 Default value -ããã©ã«ãå¤ + +(ããã©ã«ãå¤) C<yes> @@ -1306,23 +1812,36 @@ I<NON-CORE PARAMETER> from L<HTTP::WebTest::Plugin::Delay> +=begin original + Duration of pause (in seconds) before running test. +=end original + ãã¹ããå®è¡ããåã«åæ¢ããæé(ç§åä½ã§). =head3 Allowed values -使ç¨å¯è½ãªå¤ + +(使ç¨å¯è½ãªå¤) + +=begin original Any number greater that zero. +=end original + 0以éã®æ°å¤ =head2 end_test +=begin original + This is not really a parameter, it is part of L<wtscript format|/Running HTTP::WebTest using a parameter file>. It marks the end of test block. +=end original + ããã¯å®éã«ã¯ãã©ã¡ã¼ã¿ã§ã¯ããã¾ãã. L<wtscript ãã©ã¼ããã|/Running HTTP::WebTest using a parameter file> ã®ä¸é¨ã§ã. @@ -1333,17 +1852,25 @@ I<GLOBAL PARAMETER> +=begin original + A filehandle (or anything else that supports C<print>) to use for test report output. This parameter is ignored if test parameter C<output_ref> is specified also. +=end original + ãã¹ãã¬ãã¼ããåºåããããã«ä½¿ããã¡ã¤ã«ãã³ãã«(ããã㯠C<print> ããµãã¼ãããä½ã). ãã®ãã©ã¡ã¼ã¿ã¯ ãã¹ããã©ã¡ã¼ã¿ C<output_ref> ãæå®ããã¦ããã¨ãã«ã¯ç¡è¦ããã¾ã. +=begin original + This parameter can be used only when passing the test parameters as arguments from a calling Perl script. +=end original + ãã®ãã©ã¡ã¼ã¿ã¯ Perl ã¹ã¯ãªããã®ãã¹ããã©ã¡ã¼ã¿å¼æ°ã¨ã㦠渡ãããã¨ãã®ã¿ä½¿ããã¾ã. @@ -1352,72 +1879,97 @@ I<NON-CORE PARAMETER> from L<HTTP::WebTest::Plugin::Click> +=begin original + Give form name attribute (i.e. C<<form name="foo"E<gt>>) on previously requested HTML page, builds test request to the submitted page. +=end original + åã«è¦æ±ãã HTML ãã¼ã¸ã®ãã©ã¼ã ã®åå(ã¤ã¾ã C<<form name="foo"E<gt>> )ã ä¸ãããã¨ã§, ãµããããå ã®ãã¼ã¸ã¸ã®ãã¹ããªã¯ã¨ã¹ããä½ãã¾ã. +=begin original + Note that you still need to pass all form parameters yourself using C<params> test parameter. +=end original + ãã®ãã©ã¡ã¼ã¿ã使ã£ã¦ã, C<params> ãã¹ããã©ã¡ã¼ã¿ã§å ¨ã¦ã® ãã©ã¡ã¼ã¿ãæå®ããªããã°ãªããªããã¨ã«æ³¨æãã¦ãã ãã. =head2 handle_redirects +=begin original + If set to C<yes> then HTTP-WebTest automatically follows redirects. It means that you never see HTTP responses with status codes 301 and 302. This feature is disabled if this test parameter is set to C<no>. +=end original + C<yes> ã®æ HTTP-WebTest ãèªåçã«ãªãã¤ã¬ã¯ãããã©ãã¾ã. ããã«ãã£ã¦ã¹ãã¼ã¿ã¹ã³ã¼ã 301 åã³ 302 ã® HTTP ã¬ã¹ãã³ã¹ã ã¿ããã¨ã¯ãªããªãã¾ã. ãã®æ©è½ãç¡å¹ã«ããã«ã¯ãã®ãã¹ããã©ã¡ã¼ã¿ã« C<no> ãè¨å®ãã¾ã. =head3 Allowed values -使ç¨å¯è½ãªå¤ + +(使ç¨å¯è½ãªå¤) C<yes>, C<no> =head3 Default value -ããã©ã«ãå¤ + +(ããã©ã«ãå¤) C<yes> =head2 http_headers +=begin original + A list of HTTP header/value pairs. Can be used to override default HTTP headers or to add additional HTTP headers. +=end original + HTTP ããã/å¤ãã¢ã®ãªã¹ã. ããã©ã«ãã® HTTP ããããä¸æ¸ãããã HTTP ãããã追å ãããã§ãã¾ã. =head3 Example -ä¾ + +(ä¾) http_headers = ( Accept => text/plain, text/html ) =head2 ignore_case +=begin original + Option to do case-insensitive string matching for C<text_forbid>, C<text_require>, C<regex_forbid> and C<regex_require> test parameters. +=end original + C<text_forbid>, C<text_require>, C<regex_forbid> åã³ C<regex_require> ãã¹ããã©ã¡ã¼ã¿ã§å¤§æåå°æåãåºå¥ããªããããã³ã°ãè¡ããã©ããã è¨å®ãã¾ã. =head3 Allowed values -使ç¨å¯è½ãªå¤ + +(使ç¨å¯è½ãªå¤) C<yes>, C<no> =head3 Default value -ããã©ã«ãå¤ + +(ããã©ã«ãå¤) C<no> @@ -1427,9 +1979,13 @@ I<GLOBAL PARAMETER> +=begin original + Option to e-mail output to one or more addresses specified by C<mail_addresses> test parameter. +=end original + C<mail_addresses> ãã¹ããã©ã¡ã¼ã¿ã§æå®ããã¦ããï¼ã¤ã¾ãã¯ãã以ä¸ã® ã¢ãã¬ã¹ã« e-mail ã§åºåãéããã®è¨å®. @@ -1438,9 +1994,13 @@ I<GLOBAL PARAMETER> +=begin original + A list of e-mail addresses where report will be send (if sending report is enabled with C<mail> test parameter). +=end original + ã¬ãã¼ããéã e-mail ã¢ãã¬ã¹ã®ãªã¹ã(C<mail> ãã¹ããã©ã¡ã¼ã¿ã§ ã¬ãã¼ãã®éä¿¡ãæå¹ã«ããã¦ããã¨ãã ãéããã¾ã). @@ -1448,20 +2008,32 @@ =item * all +=begin original + Send e-mail containing test results. +=end original + ãã¹ãçµæãå«ãã e-mail ãéãã¾ã. =item * errors +=begin original + Send e-mail only if one or more tests fails. +=end original + ï¼ã¤ã¾ãã¯ãã以ä¸ã®ãã¹ãã失æããã¨ãã«ã ã e-mail ãéãã¾ã. =item * no +=begin original + Do not send e-mail. +=end original + e-mail ãéä¿¡ãã¾ãã. =over 8 @@ -1481,9 +2053,13 @@ I<GLOBAL PARAMETER> +=begin original + Sets C<Subject> header for test report e-mails when some tests fail. In this string some character sequences have special meaning: +=end original + 失æãããã¹ãããã£ãã¨ãã« e-mail ãã¹ãã¬ãã¼ãã® C<Subject> ããããè¨å®ãã¾ã. ãã®æååã«ã¯ç¹å¥ãªæå³ãæã¤æå並ã³ã ããã¾ã. @@ -1492,32 +2068,49 @@ =item %f +=begin original + the number of failed tests +=end original + 失æãããã¹ãã®æ° =item %s +=begin original + the number of successful tests +=end original + æåãããã¹ãã®æ° =item %t +=begin original + the total number of tests +=end original + ãã¹ãã®ç·æ° =item %% +=begin original + replaced with single C<%> +=end original + ï¼ã¤ã® C<%> ã«ç½®æããã¾ã =back =head3 Default Value -ããã©ã«ãå¤ + +(ããã©ã«ãå¤) C<WEB TESTS FAILED! FOUND %f ERROR(S)> @@ -1527,15 +2120,24 @@ I<GLOBAL PARAMETER> +=begin original + Sets From: header for test report e-mails. +=end original + e-mail ãã¹ãã¬ãã¼ãã® From: ããããè¨å®ãã¾ã. =head3 Default Value -ããã©ã«ãå¤ + +(ããã©ã«ãå¤) + +=begin original Name of user under which test script runs. +=end original + ãã¹ãã¹ã¯ãªãããå®è¡ããã¦ã¼ã¶ã®åå. =head2 mail_server @@ -1543,12 +2145,17 @@ I<GLOBAL PARAMETER> +=begin original + Fully-qualified name of of the mail server (e.g., mailhost.mycompany.com). +=end original + ã¡ã¼ã«ãµã¼ãã®å®å ¨ä¿®é£¾ãã¡ã¤ã³å(ä¾ãã° mailhost.mycompany.com). =head3 Default value -ããã©ã«ãå¤ + +(ããã©ã«ãå¤) C<localhost> @@ -1558,98 +2165,148 @@ I<GLOBAL PARAMETER> +=begin original + Sets C<Subject> header for test report e-mails when all tests are passed successfully. In this string some character sequences have special meaning (see C<mail_failure_subject> parameter for their description). +=end original + å ¨ã¦ã®ãã¹ããæåããæã®ãã¹ãã¬ãã¼ãe-mailã® C<Subject> ãããã® è¨å®. ãã®æååã«ã¯ç¹å¥ãªæå³ãæã¤æå並ã³ãããã¾ã (C<mail_failure_subject> ãã©ã¡ã¼ã¿ãåç §ãã¦ãã ãã). =head3 Default Value -ããã©ã«ãå¤ + +(ããã©ã«ãå¤) C<Web tests succeeded> =head2 max_bytes +=begin original + Maximum number of bytes expected in returned page. +=end original + è¿ããããã¼ã¸ã®äºæãããæ大ãã¤ãæ°. =head3 Allowed values -使ç¨å¯è½ãªå¤ + +(使ç¨å¯è½ãªå¤) + +=begin original Any integer greater that zero and greater than C<min_bytes> (if C<min_bytes> is specified). +=end original + 0 ãã大ããã㤠C<min_bytes> ãã大ãã(C<min_bytes> ãæå® ããã¦ããã¨ã)æ´æ°å¤. =head2 max_rtime +=begin original + Maximum web server response time (seconds) expected. +=end original + ã¦ã§ããµã¼ãããã®äºæãããæ大ã¬ã¹ãã³ã¹ã¿ã¤ã (ç§). =head3 Allowed values -使ç¨å¯è½ãªå¤ + +(使ç¨å¯è½ãªå¤) + +=begin original Any number greater that zero and greater than C<min_rtime> (if C<min_rtime> is specified). +=end original + 0 ãã大ããã㤠C<min_rtime> ãã大ãã(C<min_rtime> ãæå® ããã¦ããã¨ã)æ´æ°å¤. =head2 method -method + +=begin original HTTP request method. +=end original + HTTP ãªã¯ã¨ã¹ãã¡ã½ãã. +=begin original + See RFC 2616 (HTTP/1.1 protocol). +=end original + RFC 2616 (HTTP/1.1 ãããã³ã«)ãåç §ãã¦ãã ãã. =head3 Allowed values -使ç¨å¯è½ãªå¤ + +(使ç¨å¯è½ãªå¤) C<GET>, C<POST> =head3 Default value -ããã©ã«ãå¤ + +(ããã©ã«ãå¤) C<GET> =head2 min_bytes +=begin original + Minimum number of bytes expected in returned page. +=end original + è¿ããããã¼ã¸ã®äºæãããæå°ãã¤ãæ°. =head3 Allowed values -使ç¨å¯è½ãªå¤ + +(使ç¨å¯è½ãªå¤) + +=begin original Any integer less than C<max_bytes> (if C<max_bytes> is specified). +=end original + C<max_bytes> ããå°ãã(C<max_bytes> ãæå®ããã¦ããã¨ã)æ´æ°å¤. =head2 min_rtime +=begin original + Minimum web server response time (seconds) expected. +=end original + ã¦ã§ããµã¼ãããã®äºæãããæå°ã¬ã¹ãã³ã¹ã¿ã¤ã (ç§). =head3 Allowed values -使ç¨å¯è½ãªå¤ + +(使ç¨å¯è½ãªå¤) + +=begin original Any number less than C<max_rtime> (if C<max_rtime> is specified). +=end original + C<max_rtime> ããå°ãã(C<max_rtime> ãæå®ããã¦ããã¨ã)æ´æ°å¤. =head2 on_finish @@ -1657,20 +2314,29 @@ I<NON-CORE PARAMETER> from L<HTTP::WebTest::Plugin::Hooks> +=begin original + The value of this test parameter is ignored. However, it is evaluted before the test sequence is run, so it can be used to run finalization code when the test sequence is finished. +=end original + ãã®ãã¹ããã©ã¡ã¼ã¿ã®å¤ã¯ç¡è¦ããã¾ã. ããããã¹ãã·ã¼ã±ã³ã¹ãå®è¡ãããåã«(訳注:å¾ã«ã®ééãï¼)è©ä¾¡ããã¾ã. ã¤ã¾ããã¹ãã·ã¼ã±ã³ã¹ãçµãã£ãã¨ãã«çµäºç¨ã®ã³ã¼ããå®è¡ããããã㫠使ããã¨ãã§ãã¾ã. =head3 Example -ä¾ + +(ä¾) + +=begin original See example in L<HTTP::WebTest::Cookbook|HTTP::WebTest::Cookbook>. +=end original + L<HTTP::WebTest::Cookbook|HTTP::WebTest::Cookbook> ã«ããä¾ã åç §ãã¦ãã ãã. @@ -1679,10 +2345,14 @@ I<NON-CORE PARAMETER> from L<HTTP::WebTest::Plugin::Hooks> +=begin original + The value of this test parameter is ignored. However, it is evaluted before the HTTP request is done, so it can be used to do initalization before the request. +=end original + ãã®ãã¹ããã©ã¡ã¼ã¿ã®å¤ã¯ç¡è¦ããã¾ã. ããã HTTP ãªã¯ã¨ã¹ããè¡ãåã«è©ä¾¡ããã¾ã. ã¤ã¾ããªã¯ã¨ã¹ãåã«åæåãè¡ãããã«ä½¿ããã¨ãã§ãã¾ã. @@ -1692,43 +2362,61 @@ I<NON-CORE PARAMETER> from L<HTTP::WebTest::Plugin::Hooks> +=begin original + This is a list parameter which is treated as test result. It is evaluted when the HTTP response for the test request is received. +=end original + ãã¹ãçµæã¨ãã¦å¦çããããªã¹ããã©ã¡ã¼ã¿ãè¨å®ãã¾ã. ããã¯ãã¹ããªã¯ã¨ã¹ãã«å¯¾ãã HTTP ã¬ã¹ãã³ã¹ãåä¿¡ããã¨ãã« è©ä¾¡ããã¾ã. +=begin original + It can be used to define custom tests without writing new plugins. It can also be used to run some code when the HTTP response for the test request is received. +=end original + ãã®ãã©ã¡ã¼ã¿ã¯æ°ãããã©ã°ã¤ã³ãæ¸ããã¨ãªãã«ã«ã¹ã¿ã ãã¹ãã å®ç¾©ããããã«ä½¿ããã¨ãã§ãã¾ã. ãã¹ããªã¯ã¨ã¹ãã«å¯¾ãã HTTP ã¬ã¹ãã³ã¹ãåä¿¡ããã¨ãã«ä½ããã®ã³ã¼ããå®è¡ããããã«ä½¿ããã¨ã ã§ãã¾ã. =head3 Allowed values -使ç¨å¯è½ãªå¤ + +(使ç¨å¯è½ãªå¤) ( YESNO1, COMMENT1 YESNO2, COMMENT2 .... YESNON, COMMENTN ) +=begin original + Here C<YESNO>, C<COMMENT> is a test result. C<YESNO> is either C<yes> if test is successful or C<no> if it is not. C<COMMENT> is a comment associated with this test. +=end original + C<YESNO>, C<COMMENT> ã¯ãã¹ãçµæã§ã. C<YESNO> 㯠æåæãªã C<yes>, ããã§ãªããã° C<no> ã®ã©ã¡ããã§ã. C<COMMENT> ã¯ãã®ãã¹ãã«é¢é£ããã³ã¡ã³ãã§ã. =head3 Example -ä¾ + +(ä¾) + +=begin original See example in L<HTTP::WebTest::Cookbook|HTTP::WebTest::Cookbook>. +=end original + L<HTTP::WebTest::Cookbook|HTTP::WebTest::Cookbook> ã«ããä¾ã åç §ãã¦ãã ãã. @@ -1737,19 +2425,28 @@ I<NON-CORE PARAMETER> from L<HTTP::WebTest::Plugin::Hooks> +=begin original + The value of this test parameter is ignored. However, it is evaluted before the test sequence is run, so it can be used to do initalization before the test sequence run. +=end original + ãã®ãã¹ããã©ã¡ã¼ã¿ã®å¤ã¯ç¡è¦ããã¾ã. ããããã¹ãã·ã¼ã±ã³ã¹ãå®è¡ãããåã«è©ä¾¡ããã¾ã. ã¤ã¾ããã¹ãã·ã¼ã±ã³ã¹ãå®è¡ãããåã«åæåãè¡ãããã«ä½¿ããã¨ãã§ãã¾ã. =head3 Example -ä¾ + +(ä¾) + +=begin original See example in L<HTTP::WebTest::Cookbook|HTTP::WebTest::Cookbook>. +=end original + L<HTTP::WebTest::Cookbook|HTTP::WebTest::Cookbook> ã«ããä¾ã åç §ãã¦ãã ãã. @@ -1758,36 +2455,56 @@ I<GLOBAL PARAMETER> +=begin original + A reference to a scalar that accumulates text of test report. If this test parameter is specified then value of test parameter C<fh_out> is ignore. +=end original + ãã¹ãã¬ãã¼ãã®ããã¹ããèç©ãããããã®ã¹ã«ã©ã¼ã¸ã®ãªãã¡ã¬ã³ã¹ã æå®ãã¾ã. ãã®ãã©ã¡ã¼ã¿ãæå®ããã¦å¤æ㯠C<fh_out> ãã¹ã ãã©ã¡ã¼ã¿ã®å¤ã¯ç¡è¦ããã¾ã. +=begin original + This parameter can be used only when passing the test parameters as arguments from a calling Perl script. +=end original + ãã®ãã©ã¡ã¼ã¿ã¯ Perl ã¹ã¯ãªããã®ãã¹ããã©ã¡ã¼ã¿å¼æ°ã¨ã㦠渡ãããã¨ãã®ã¿ä½¿ããã¾ã. =head2 params +=begin original + A list of name/value pairs to be passed as parameters to the URL. (This element is used to test pages that process input from forms.) +=end original + URL ã«ãã©ã¡ã¼ã¿ã¨ãã¦æ¸¡ãåå/å¤ãã¢ã®ãªã¹ã. (ãã®è¦ç´ ã¯ãã©ã¼ã ããã®å ¥åãå¦çãããã¼ã¸ã®ãã¹ãã®ããã«ä½¿ãã¾ã.) +=begin original + If the method key is set to C<GET>, these pairs are URI-escaped and appended to the requested URL. +=end original + method ãã¼ã« C<GET> ãè¨å®ããã¦ããã®ãªããããã®ãã¢ã¯ URI-ã¨ã¹ã±ã¼ãããã¦ãªã¯ã¨ã¹ãURLã«è¿½å ããã¾ã. +=begin original + Example (wtscript file): +=end original + ä¾ (wtscript ãã¡ã¤ã«): url = http://www.hotmail.com/cgi-bin/hmhome @@ -1796,28 +2513,40 @@ from HotMail ) +=begin original + generates the HTTP request with URI: +=end original + çæããã HTTP ãªã¯ã¨ã¹ã URI: http://www.hotmail.com/cgi-bin/hmhome?curmbox=F001%20A005&from=HotMail +=begin original + If the method key is set to C<POST>, as long as all values are scalars they are URI-escaped and put into content of the HTTP request. C<application/x-www-form-urlencoded> content type is set for such HTTP request. +=end original + ããã¡ã½ãããã¼ã C<POST> ã«è¨å®ããã¦ããã¨ãã¯åãããã« URI-ã¨ã¹ã±ã¼ããã, HTTP ãªã¯ã¨ã¹ãã®æ¬ä½ã§éããã¾ã. ãã®æ, HTTP ãªã¯ã¨ã¹ãã« C<application/x-www-form-urlencoded> ã³ã³ãã³ãã¿ã¤ããè¨å®ããã¾ã. +=begin original + If the method key is set to C<POST>, some values may be defined as lists. In this case L<HTTP::WebTest|HTTP::WebTest> uses C<multipart/form-data> content type used for C<Form-based File Upload> as specified in RFC 1867. Each parameter with list value is treated as file part specification with the following interpretation: +=end original + method ãã¼ã C<POST> ã«è¨å®ããã¦ããã®ãªãå¤ããªã¹ãã§å®ç¾©ãã ãã¨ãã§ãã¾ã. ãã®æ L<HTTP::WebTest|HTTP::WebTest> 㯠RFC 1867 㧠ä»æ§åããã¦ãã C<ãã©ã¼ã ãã¼ã¹ã®ãã¡ã¤ã«ã¢ãããã¼ã> ã®ããã« @@ -1826,37 +2555,57 @@ ( FILE, FILENAME, HEADER => VALUE... ) +=begin original + where +=end original + ããããã®æå³ã¯ä»¥ä¸ã®éãã§ã. =over 4 =item * FILE +=begin original + The name of a file to open. This file will be read and its content placed in the request. +=end original + èªã¿è¾¼ããã¡ã¤ã«ã®åå. ãã®ãã¡ã¤ã«ã®ä¸èº«ããªã¯ã¨ã¹ãã«ä½¿ããã¾ã. =item * FILENAME +=begin original + The optional filename to be reported in the request. If it is not specified than basename of C<FILE> is used. +=end original + ãªã¯ã¨ã¹ãã§å ±åããä»»æã®ãã¡ã¤ã«å. æå®ãããªãã£ãã¨ã㯠C<FILE> ã®ãã¼ã¹ãã¼ã ã使ããã¾ã. =item * HEADER => VALUE +=begin original + Additional optional headers for file part. +=end original + ãã¡ã¤ã«ãã¼ãã®ä»»æã®è¿½å ããã. =back +=begin original + Example (wtscript file): +=end original + ä¾ (wtscript ãã¡ã¤ã«): url = http://www.server.com/upload.pl @@ -1864,17 +2613,25 @@ params = ( submit => ok file => ( '/home/ilya/file.txt', 'myfile.txt' ) ) +=begin original + It generates HTTP request with C</home/ilya/file.txt> file included and reported under name C<myfile.txt>. +=end original + ãã㯠C<myfile.txt> ã¨ããåå㧠C</home/ilya/file.txt> ã®ä¸èº«ã éã HTTP ãªã¯ã¨ã¹ããçæãã¾ã. =head2 pauth +=begin original + A list which contains two elements: userid/password pair to be used for proxy server access authorization. +=end original + ï¼ã¤ã®è¦ç´ , ãããã·ãµã¼ãã«ã¢ã¯ã»ã¹ããããã®èªè¨¼ã®ã¦ã¼ã¶å/ãã¹ã¯ã¼ãã® ãã¢ãå«ããªã¹ã. @@ -1883,10 +2640,14 @@ I<GLOBAL PARAMETER> +=begin original + A list of module names. Loads these modules and registers them as L<HTTP::WebTest|HTTP::WebTest> plugins. If the name of the plugin starts with C<::>, it is prepended with C<HTTP::WebTest::Plugin>. So +=end original + ã¢ã¸ã¥ã¼ã«åã®ãªã¹ã. ãããã®ã¢ã¸ã¥ã¼ã«ã¯ãã¼ããã, L<HTTP::WebTest|HTTP::WebTest> ãã©ã°ã¤ã³ã¨ãã¦ç»é²ããã¾ã. ãã ãã©ã°ã¤ã³ã®ååã C<::> ããå§ã¾ãæ㯠C<HTTP::WebTest::Plugin> ãåã« @@ -1894,188 +2655,268 @@ plugins = ( ::Click ) +=begin original + is equal to +=end original + ã¯æ¬¡ã¨ç価ã§ã. plugins = ( HTTP::WebTest::Plugin::Click ) =head2 proxies +=begin original + A list of service name/proxy URL pairs that specify proxy servers to use for requests. +=end original + ãªã¯ã¨ã¹ãã«ä½¿ãããã®ãããã·ãµã¼ããæå®ãã ãµã¼ãã¹å/ãããã·URLã®ãã¢ã®ãªã¹ã. =head3 Example -ä¾ + +(ä¾) proxies = ( http => http://http_proxy.mycompany.com ftp => http://ftp_proxy.mycompany.com ) =head2 regex_forbid +=begin original + List of regular expressions that are forbidden to exist in the returned page. +=end original + è¿ããããã¼ã¸ã®ä¸ã«åå¨ãããã¨ãç¦æ¢ããæ£è¦è¡¨ç¾ã®ãªã¹ã. +=begin original + For more information, see L<perldoc perlre|perlre> or see Programming Perl, 3rd edition, Chapter 5. +=end original + 詳細ã«é¢ãã¦ã¯, L<perldoc perlre|perlre> ãããã¯ããã°ã©ãã³ã°è¨èª Perl 第ï¼ç 第ï¼ç« ãåç §ãã¦ãã ãã. +=begin original + See also the C<text_forbid> and C<ignore_case> parameters. +=end original + C<text_forbid> åã³ C<ignore_case> ãã©ã¡ã¼ã¿ãåç §ãã¦ãã ãã. =head2 regex_require +=begin original + List of regular expressions that are required to exist in the returned page. +=end original + è¿ããããã¼ã¸ã®ä¸ã«åå¨ãããã¨ãè¦æ±ããæ£è¦è¡¨ç¾ã®ãªã¹ã. +=begin original + For more information, see L<perldoc perlre|perlre> or see Programming Perl, 3rd edition, Chapter 5. +=end original + 詳細ã«é¢ãã¦ã¯, L<perldoc perlre|perlre> ãããã¯ããã°ã©ãã³ã°è¨èª Perl 第ï¼ç 第ï¼ç« ãåç §ãã¦ãã ãã. +=begin original + See also the C<text_require> and C<ignore_case> parameters. +=end original + C<text_require> åã³ C<ignore_case> ãã©ã¡ã¼ã¿ãåç §ãã¦ãã ãã. =head2 relative_urls +=begin original + If set to C<yes> than C<HTTP-WebTest> supports relative URLs. See test parameter C<url> for more information. +=end original + C<yes> ãè¨å®ãããã¨ã§ C<HTTP-WebTest> ãç¸å¯¾URL ããµãã¼ãããããã« ãªãã¾ã. ããå¤ãã®æ å ±ã¯ C<url> ãã¹ããã©ã¡ã¼ã¿ãåç §ãã¦ãã ãã. =head3 Allowed values -使ç¨å¯è½ãªå¤ + +(使ç¨å¯è½ãªå¤) C<yes>, C<no> =head3 Default value -ããã©ã«ãå¤ + +(ããã©ã«ãå¤) C<no> =head2 send_cookies +=begin original + Option to send cookies to web server. This applies to cookies received from the web server or cookies specified using the C<cookies> test parameter. +=end original + ã¦ã§ããµã¼ãã®ã¯ããã¼ãéãããè¨å®ãã¾ã. ããã¯ã¦ã§ããµã¼ããã åãåã£ãã¯ããã¼ã«ã C<cookies> ãã¹ããã©ã¡ã¼ã¿ã§æå®ããã ã¯ããã¼ã«ãé©ç¨ããã¾ã. +=begin original + This does NOT give the web server(s) access to cookies created with a browser or any user agent software other than this program. The cookies created while this program is running are only accessible to other tests in the same test sequence. +=end original + ããã¯ã¦ã§ããµã¼ãã«ãã©ã¦ã¶ãä»ã®ãã®ããã°ã©ã 以å¤ã®ã¦ã¼ã¶ã¨ã¼ã¸ã§ã³ã ã½ããã¦ã§ã¢ãä½ã£ãã¯ããã¼ã¸ã®ã¢ã¯ã»ã¹ãç¦ãããã®ã§ã¯ããã¾ãã. ãã®ããã°ã©ã ã®å®è¡ä¸ã«çæãããã¯ããã¼ã¯åããã¹ãã·ã¼ã±ã³ã¹å ã® ä»ã®ãã¹ãããã®ã¿ã¢ã¯ã»ã¹å¯è½ã§ã. +=begin original + See also the <accept_cookies> parameter. +=end original + <accept_cookies> ãã©ã¡ã¼ã¿ãåç §ãã¦ãã ãã. =head3 Allowed values -使ç¨å¯è½ãªå¤ + +(使ç¨å¯è½ãªå¤) C<yes>, C<no> =head3 Default value -ããã©ã«ãå¤ + +(ããã©ã«ãå¤) C<yes> =head2 show_cookies +=begin original + Option to display any cookies sent or received. +=end original + éåä¿¡ããã¯ããã¼ã表示ããããè¨å®ãã¾ã. =head3 Allowed values -使ç¨å¯è½ãªå¤ + +(使ç¨å¯è½ãªå¤) C<yes>, C<no> =head3 Default value -ããã©ã«ãå¤ + +(ããã©ã«ãå¤) C<no> =head2 show_headers +=begin original + Include request and response headers in the test report. +=end original + ãã¹ãã¬ãã¼ãã®ãªã¯ã¨ã¹ããããåã³ã¬ã¹ãã³ã¹ããããå«ãããã è¨å®ãã¾ã. =head3 Allowed values -使ç¨å¯è½ãªå¤ + +(使ç¨å¯è½ãªå¤) C<yes>, C<no> =head3 Default value -ããã©ã«ãå¤ + +(ããã©ã«ãå¤) C<no> =head2 show_html +=begin original + Include content of HTTP response in the test report. +=end original + ãã¹ãã¬ãã¼ãã« HTTP ã¬ã¹ãã³ã¹ãå«ããããè¨å®ãã¾ã. =head3 Allowed values -使ç¨å¯è½ãªå¤ + +(使ç¨å¯è½ãªå¤) C<yes>, C<no> =head3 Default value -ããã©ã«ãå¤ + +(ããã©ã«ãå¤) C<no> =head2 status_code +=begin original + Given numeric HTTP Status Code, tests response returned that value. +=end original + æ°å¤ã§ HTTP ã¹ãã¼ã¿ã¹ã³ã¼ããä¸ããã¨, ã¬ã¹ãã³ã¹ã§ ãã®å¤ãè¿ããããããã¹ããã¾ã. =head3 Default value -ããã©ã«ãå¤ + +(ããã©ã«ãå¤) C<200> (OK). =head2 terse +=begin original + Option to display shorter test report. +=end original + çããã¹ãã¬ãã¼ãã表示ããããè¨å®ãã¾ã. =over 4 @@ -2084,20 +2925,32 @@ * summary (è¦ç´) +=begin original + Only a one-line summary for each URL +=end original + å URL ã®ï¼è¡è¦ç´ã®ã¿ =item * failed_only +=begin original + Only tests that failed and the summary +=end original + 失æãããã¹ãã¨è¦ç´ã®ã¿ =item * no +=begin original + Show all tests and the summary +=end original + å ¨ã¦ã®ãã¹ãã¨è¦ç´ã表示 =over 8 @@ -2114,63 +2967,100 @@ =head2 test_name +=begin original + Name associated with this URL in the test report and error messages. +=end original + URL ã«é¢é£ã¥ããããåå. ãã¹ãã¬ãã¼ããã¨ã©ã¼ã¡ãã»æã§ä½¿ããã¾ã. =head2 text_forbid +=begin original + List of text strings that are forbidden to exist in the returned page. +=end original + è¿ããããã¼ã¸ã®ä¸ã«åå¨ãããã¨ãç¦æ¢ããããã¹ãæååã®ãªã¹ã. +=begin original + See also the C<regex_forbid> and C<ignore_case> parameters. +=end original + C<regex_forbid> åã³ C<ignore_case> ãã©ã¡ã¼ã¿ãåç §ãã¦ãã ãã. =head2 text_require +=begin original + List of text strings that are required to exist in the returned page. +=end original + è¿ããããã¼ã¸ã®ä¸ã«åå¨ãããã¨ãè¦æ±ããããã¹ãæååã®ãªã¹ã. +=begin original + See also the C<regex_require> and C<ignore_case> parameters. +=end original + C<regex_require> åã³ C<ignore_case> ãã©ã¡ã¼ã¿ãåç §ãã¦ãã ãã. =head2 timeout +=begin original + Set the timeout value in seconds. +=end original + ã¿ã¤ã ã¢ã¦ãå¤ãç§ã§è¨å®ãã¾ã. =head3 Default value -ããã©ã«ãå¤ + +(ããã©ã«ãå¤) C<180> =head2 url +=begin original + URL to test. +=end original + ãã¹ãããURL. +=begin original + If test parameter C<relative_urls> is set to C<yes> than URL for each test is treated as relative to the URL in the previous test. URL in the first test is treated as relative to C<http://localhost>. +=end original + ãã¹ããã©ã¡ã¼ã¿ C<relative_urls> ã C<yes> ã«è¨å®ããã¦ããã¨ã㯠ï¼ã¤åã®ãã¹ãã® URL ããã®ç¸å¯¾URLã¨ãã¦å¦çããã¾ã. æåã®ãã¹ãã§ã¯ C<http://localhost> ããã®ç¸å¯¾ã¨ãã¦å¦çããã¾ã. +=begin original + If test parameter C<relative_urls> is set to C<no> than each URL is treated as absolute. In this case if schema part of URL is omitted (i.e. URL doesn't start with C<http://>, C<ftp://>, etc) then C<http://> is implied. +=end original + ãã¹ããã©ã¡ã¼ã¿ C<relative_urls> ã C<no> ã«è¨å®ããã¦ããã¨ã㯠絶対URLã¨ãã¦å¦çããã¾ã. ãã®æ, URL ã®ã¹ãã¼ãé¨åãçç¥ããã¦ãã æ(ã¤ã¾ãURLãC<http://>, C<ftp://> çã§å§ã¾ã£ã¦ããªãæ)㯠@@ -2178,36 +3068,54 @@ =head2 user_agent +=begin original + Set the product token that is used to identify the user agent on the network. +=end original + ãããã¯ã¼ã¯ä¸ã§ã¦ã¼ã¶ã¨ã¼ã¸ã§ã³ããèå¥ããããã«ä½¿ããã 製åãã¼ã¯ã³ãè¨å®ãã¾ã. =head3 Default value -ããã©ã«ãå¤ + +(ããã©ã«ãå¤) C<HTTP-WebTest/NN> +=begin original + where C<NN> is version number of HTTP-WebTest. +=end original + C<NN> 㯠HTTP-WebTest ã®ãã¼ã¸ã§ã³çªå·ã§ã. =head1 RESTRICTIONS / BUGS -å¶é / ãã° + +(å¶é / ãã°) + +=begin original This module have been tested only on Unix (e.g., Solaris, Linux, AIX, etc.) but it should work on Win32 systems. +=end original + ãã®ã¢ã¸ã¥ã¼ã«ã¯ Unix (ä¾ãã° Solaris, Linux, AIX ç)ã§ã®ã¿ãã¹ã ããã¦ãã¾ãã WIn32 ã§ãåä½ããã§ããã. +=begin original + If you want to test https:// web sites you may have to install additional modules to enable SSL support in L<LWP>. In short you may have to install L<Crypt::SSLeay> module. For details see README.SSL file in L<LWP> distro. +=end original + https:// ã¦ã§ããµã¤ãããã¹ãããã«ã¯ L<LWP> 㧠SSL ãµãã¼ãã æå¹ã«ããããã®è¿½å ã¢ã¸ã¥ã¼ã«ã®ã¤ã³ã¹ãã¼ã«ãå¿ è¦ã§ããã. ç°¡åã«ãã£ã¦ãã¾ãã° L<Crypt::SSLeay> ã¢ã¸ã¥ã¼ã«ãã¤ã³ã¹ãã¼ã« @@ -2215,30 +3123,46 @@ åç §ãã¦ãã ãã. =head1 AUTHORS -èè + +(èè ) + +=begin original Richard Anderson <richa****@richa*****> wrote C<HTTP::WebTest 1.xx>, using some ideas from the CPAN Monkeywrench module. +=end original + Richard Anderson <richa****@richa*****>, C<HTTP::WebTest 1.xx> ãä½æ, CPAN Monkeywrench ã¢ã¸ã¥ã¼ã«ãã ã¢ã¤ãã¢ãã²ããã. +=begin original + Ilya Martynov <ilya****@marty*****> implemented the plug-in concept, the extended API and completely rewrote C<HTTP::WebTest>. +=end original + Ilya Martynov <ilya****@marty*****> ãã©ã°ã¤ã³æ§æ³ã®å®è£ , æ¡å¼µ API åã³ C<HTTP::WebTest> ã®å®å ¨ãªæ¸ãç´ã. +=begin original + Please don't email authors directly. Use the SourceForge C<HTTP::WebTest> mail list (see SUPPORT, next section). +=end original + èè ã«ç´æ¥ email ãéããªãã§ãã ãã. SourceForge ã® C<HTTP::WebTest> ã¡ã¼ãªã³ã°ãªã¹ãã使ã£ã¦ãã ãã (次ã®ã»ã¯ã·ã§ã³, ãµãã¼ããåç §ãã¦ãã ãã). =head1 SUPPORT -ãµãã¼ã + +(ãµãã¼ã) + +=begin original Please email bug reports, suggestions, questions, etc. to the SourceForge C<HTTP::WebTest> maillist. @@ -2246,6 +3170,8 @@ http://lists.sourceforge.net/lists/listinfo/http-webtest-general . The email address is C<http-****@lists*****>. +=end original + ãã°ã¬ãã¼ã, ææ¡, 質åãªã©ã¯ SourceForge ã® C<HTTP::WebTest> ã¡ã¼ãªã³ã°ãªã¹ãã« email ãéã£ã¦ãã ãã. http://lists.sourceforge.net/lists/listinfo/http-webtest-general 㧠@@ -2253,7 +3179,8 @@ ã§ã. =head1 COPYRIGHT -èä½æ¨© + +(èä½æ¨©) Copyright (c) 2000-2001 Richard Anderson. All rights reserved. @@ -2261,14 +3188,19 @@ Copyright (c) 2001-2003 Ilya Martynov. All rights reserved. +=begin original + This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. +=end original + ãã®ããã°ã©ã ã¯ããªã¼ã½ããã§ã. ãã®ããã°ã©ã 㯠Perl èªèº«ã¨åãæ¡ä»¶ä¸ã§ åé å¸ã»æ¹å¤å¯è½ã§ã. =head1 SEE ALSO -é¢é£é ç® + +(é¢é£é ç®) L<HTTP::WebTest::Cookbook|HTTP::WebTest::Cookbook>