Template:Тест cасе/доc
| Ушбу саҳифа Тест cасе андозасининг ҳужжат саҳифасидир. Бу ерда андозанинг асосий саҳифасидан жой олмаган фойдаланиш қоидалари, туркумлар ва бошқа фойдали маълумотлар жойлаштирилади. |
| Бу андоза қуйидаги Луадан фойдаланади: |
Тҳис темплате генератес а тест cасе фор тwо ор море темплатес. Эач темплате ис cаллед wитҳ тҳе саме параметерс, анд тҳе тест cасе cан бе дисплаед ин вариоус дифферент формац.
Алл параметерс пассед то тҳис темплате аре пассед тҳроугҳ то тҳе тест-cасе темплатес, wитҳ тҳе эхcептион оф параметерс стартинг wитҳ ан ундерсcоре чараcтер ("_"), wҳич аре ресервед фор интернал усе.
Иф но темплатес аре спеcифиэд эхплиcитлй, тҳе модуле усес тҳе басе паге оф тҳе cуррент паге ас тҳе фирст темплате, анд иц /сандбох субпаге ас тҳе сеcонд темплате. Иф онлй оне темплате ис спеcифиэд эхплиcитлй, иц /сандбох субпаге ис усед ас тҳе сеcонд темплате.
Усаге
Басиc сйнтах
{{test case
| [param1] = [value1]
| [param2] = [value2]
| [param3] = [value3]
...
}}
Cоммон сйнтах
Тҳе фоллоwинг оптионс wилл wорк wитҳ алл дифферент тест cасе формац.
{{test case
| _format =
| _output =
| _collapsible =
| _resetRefs =
| _code =
| _showcode =
| _template =
| _template1 =
| _heading1 =
| _template2 =
| _heading2 =
| _template3 =
| _heading3 =
...
| [param1] = [value1]
| [param2] = [value2]
| [param3] = [value3]
...
}}
Соме тест cасе формац аccепт аддитионал параметерс ас wелл. Сеэ тҳеир сеcтионс фор доcументатион.
Cоммон параметерс
| Параметер | Десcриптион |
|---|---|
_format |
Тҳе формат усед то дисплай тҳе тест cасес. Тҳис cан бе "cолумнс", "роwс", "таблероwс", "инлине" ор "дефаулт". |
_output |
Аллоwс чангес ин ҳоw тҳе темплате'с оутпут ис дисплаед. Тҳе дефаулт оутпут ис дисплаед wҳен тҳе _оутпут параметер ис нот спеcифиэд ор wҳен ит ис сет то анй унсуппортед валуэ. А ноwики версион оф тҳе темплате'с оутпут ис дисплаед wҳен |_оутпут=ноwики; тҳис ис ҳелпфул wҳен тҳере аре дифференcес ин тҳе ундерлйинг wикитехт wҳич аре нот висибле ин тҳе дефаулт оутпут. Ботҳ тҳе дефаулт оутпут анд ноwики версион аре дисплаед wҳен |_оутпут=ноwики+.
|
_collapsible |
Иф сет то "й" ор "ес", тҳе тест cасе ис маде cоллапсибле. Тҳе тест cасе ис cоллапсед анд гивен а греэн ҳеадинг иф алл тҳе темплате оутпуц аре тҳе саме. Иф анй оф тҳе темплате оутпуц диффер, тҳе тест cасе ис эхпандед анд гивен а еллоw ҳеадинг. Сеэ #Cоллапсибле тест cасес фор отҳер параметерс wҳич онлй wорк wҳен _cоллапсибле ис энаблед. |
_template1, _template2, _template3... |
Тҳе намес оф тҳе темплатес то бе проcессед. Тҳе дефаулт оф _темплате1 ис тҳе басе паге оф тҳе cуррент паге. Иф _темплате1 ис спеcифиэд, тҳе дефаулт фор _темплате2 ис иц /сандбох субпаге; иф нот, тҳе дефаулт фор _темплате2 ис тҳе /сандбох субпаге оф тҳе басе паге оф тҳе cуррент паге. Темплате намес шоулд бе энтеред ас ёу wоулд усе тҳем ин а нормал темплате инвоcатион, и.э. "3х", нот "Темплате:3х". Иф ёу неэд то тест а паге ин тҳе маин намеспаcе ёу cан усе а cолон префих, и.э. ":артиcле наме". |
_template |
Ан алиас фор _темплате1. Иф ботҳ _темплате анд _темплате1 аре спеcифиэд, _темплате wилл таке преcеденcе. |
_showtemplate1, _showtemplate2, _showtemplate3... |
Иф тҳис ис сет то "но", тҳен но оутпут ис шоwн фор тҳат темплате. Тҳис ис усефул иф ёу онлй wант то шоw тҳе маин темплате, ор иф ёу онлй wант то шоw тҳе сандбох темплате. |
_heading1, _heading2, _heading3... |
Cустом ҳеадингс фор эач оф тҳе темплатес. |
_showheader |
Иф тҳис ис сет то "н" ор "но", тҳен но ҳеадерс аре шоwн. |
_before, _after |
Оптионал техт то дисплай бефоре анд афтер тҳе оутпут оф эач темплате. |
_resetRefs |
Иф сет то "й" ор "ес", анй референcес генератед бй тҳе темплатес тестед аре ресет афтер эач темплате ис эхпандед. |
_showcode |
Шоw тҳе темплате cоде усед то маке тҳе тест cасе. Иф ан инвоcатион ис спеcифиэд wитҳ тҳе _cоде параметер, тҳен тҳат ис усед. Отҳерwисе, ан аппрохиматион ис генератед фром тҳе аргуменц. Тҳис аппрохиматион ис нот перфеcт - wҳите спаcе ин намед аргуменц ис лост, анд дуплиcате аргуменц аре игноред - бут ит шоулд бе фине фор темплате cоде тҳат ис инпут алл он оне лине wитҳоут спаcес бетwеэн параметерс. |
_code |
Усед то спеcифй темплате cоде инсиде <ноwики>...</ноwики> тагс. Тҳис ис усед wитҳ тҳе _шоwcоде оптион то дисплай тҳе темплате инвоcатион wҳиле пресервинг wҳите спаcе. Ёу муст усе тҳе магиc wорд "__ТЕМПЛАТЕНАМЕ__" инстеад оф тҳе темплате наме. Фор эхампле: | _code = <nowiki>{{__TEMPLATENAME__|first|second|foo=bar}}</nowiki>. Иф ёу финд ёурселф усинг тҳис оптион а лот, ёу май wант то cонсидер усинг {{тест cасе ноwики}}, wҳич аллоwс ёу то генерате тҳе энтире тест cасе фром темплате cоде ин ноwики тагс, савинг ёу фром тйпинг ин алл тҳе аргуменц тwиcе. Ноте: дуэ то тҳе wай ноwики тагс wорк, тҳе темплате треац тҳе ҲТМЛ энтитиэс &лт;, &гт; анд &қуот; ас иф тҳей wере тҳе литерал чараcтерс <, > анд " wҳен усед wитҳ тҳис параметер. |
Тест cасе формац
Дефаулт формат
Тҳис формат ис усед wҳен _формат ис нот спеcифиэд ор wҳен |_формат=дефаулт. Ит доэс нот ҳаве анй эхтра параметерс.
Эхампле
Луа хатоси ин паcкаге.луа ат лине 80: модуле 'Модуле:Темплате тест cасе/дата' нот фоунд.
Cолумнс формат
Усе |_формат=cолумнс то арранге тҳе тест cасес сиде бй сиде ин а табле. Тҳис ис усефул фор cомпаринг лонг анд тҳин темплатес суч ас инфобохес. Ит ҳас тҳе фоллоwинг эхтра параметерс:
| Параметер | Десcриптион |
|---|---|
_class |
ҲТМЛ cлассес фор тҳе табле. Усе |_cласс=wикитабле то формат тҳе табле ас а wикитабле.
|
_style |
Cустом инлине CСС фор тҳе табле. |
_caption |
Cустом cаптион фор тҳе табле. Тҳе дефаулт ис "Сиде бй сиде cомпарисон". |
_rowheader |
Ан эхтра ҳеадинг фор тҳе роw cонтаининг тҳе темплатес. |
_heading0 |
Иф _роwҳеадер ис супплиэд, тҳис ис ан оптионал ҳеадинг абове ит ин тҳе темплате роw. |
Эхампле
Луа хатоси ин паcкаге.луа ат лине 80: модуле 'Модуле:Темплате тест cасе/дата' нот фоунд.
Роwс анд таблероwс формац
Усе |_формат=роwс ор |_формат=таблероwс то арранге тҳе тест cасес оне абове анотҳер ин а табле. Тҳесе тwо формац диффер ин тҳе плаcемент оф тҳе ҳеадингс: роwс пуц тҳем абове, wҳереас таблероwс то тҳе лефт оф тҳе темплате оутпуц. Ит ҳас тҳе фоллоwинг эхтра параметерс:
| Параметер | Десcриптион |
|---|---|
_class |
ҲТМЛ cлассес фор тҳе табле. Усе |_cласс=wикитабле то формат тҳе табле ас а wикитабле.
|
_style |
Cустом инлине CСС фор тҳе табле. |
_caption |
Cустом cаптион фор тҳе табле. |
Эхампле – роwс
Луа хатоси ин паcкаге.луа ат лине 80: модуле 'Модуле:Темплате тест cасе/дата' нот фоунд.
Эхампле – таблероwс
Луа хатоси ин паcкаге.луа ат лине 80: модуле 'Модуле:Темплате тест cасе/дата' нот фоунд.
Инлине формат
Усе |_формат=инлине фор тест cасес тҳат cан бе дисплаед энтирелй он оне лине. Иф усед wитҳ темплатес тҳат дисплай он мултипле линес ит май продуcе унехпеcтед ресулц. Тҳис формат cреатес а буллетед лист бй плаcинг * бефоре эач лине оф оутпут. Ит ҳас тҳе фоллоwинг эхтра параметерс:
| Параметер | Десcриптион |
|---|---|
_addline |
Техт то бе аддед ас ласт лине ин лист, афтер тҳе темплате оутпут. |
_prefix |
Чараcтер то реплаcе * бефоре эач лине оф оутпут. Усинг |_префих=# wоулд дисплай а нумберед лист.
|
Ноте: Ас тҳис формат старц wитҳ а буллет, а неwлине wилл алwайс бе инсертед ат тҳе старт оф тҳе темплате оутпут дуэ то буг 14974.
Эхамплес (усинг Темплате:3х)
Дефаулт: Луа хатоси ин паcкаге.луа ат лине 80: модуле 'Модуле:Темплате тест cасе/дата' нот фоунд.
Wитҳ |_шоwcоде=ес:
Луа хатоси ин паcкаге.луа ат лине 80: модуле 'Модуле:Темплате тест cасе/дата' нот фоунд.
Эхампле (усинг Темплате:Ҳеигҳт)
Wитҳ |_префих=# анд |_аддлине=:
Луа хатоси ин паcкаге.луа ат лине 80: модуле 'Модуле:Темплате тест cасе/дата' нот фоунд.
Оутпут
Тҳе _оутпут параметер аллоwс чангес ин ҳоw тҳе темплате'с оутпут ис дисплаед. Ит шоулд wорк wитҳ анй оф тҳе тест cасе формац; тҳе фоллоwинг эхамплес усе |формат=таблероwс.
Дефаулт оутпут
Тҳе дефаулт оутпут ис дисплаед wҳен тҳе _оутпут параметер ис нот спеcифиэд ор wҳен ит ис сет то анй унсуппортед валуэ; тҳис эхампле усес |_оутпут=дефаулт.
Луа хатоси ин паcкаге.луа ат лине 80: модуле 'Модуле:Темплате тест cасе/дата' нот фоунд.
Ноwики оутпут
А ноwики версион оф тҳе темплате'с оутпут ис дисплаед wҳен |_оутпут=ноwики. Тҳис ис ҳелпфул иф тҳере аре дифференcес ин тҳе ундерлйинг wикитехт wҳич аре нот висибле ин тҳе дефаулт оутпут.
Луа хатоси ин паcкаге.луа ат лине 80: модуле 'Модуле:Темплате тест cасе/дата' нот фоунд.
Ноwики+ оутпут
Ботҳ тҳе дефаулт оутпут анд ноwики версион аре дисплаед wҳен |_оутпут=ноwики+.
Луа хатоси ин паcкаге.луа ат лине 80: модуле 'Модуле:Темплате тест cасе/дата' нот фоунд.
Cоллапсибле тест cасес
Иф _collapsible ис сет то "й" ор "ес", тҳе тест cасе ис маде cоллапсибле. Тҳе тест cасе ис cоллапсед анд гивен а греэн ҳеадинг иф алл тҳе темплате оутпуц аре тҳе саме. Иф анй оф тҳе темплате оутпуц диффер, тҳе тест cасе ис эхпандед анд гивен а еллоw ҳеадинг. Ит ҳас тҳе фоллоwинг эхтра параметерс:
| Параметер | Десcриптион |
|---|---|
_title |
Усе |_титле= то дисплай а cустом титле фор cоллапсибле тест cасес.
|
_titlecode |
Усе |_титлеcоде=ес то дисплай тҳе темплате'с cоде ас тҳе титле оф а cоллапсибле тест cасе.
|
_notcollapsed |
Иф сет то y ор yes, тҳе тест cасе wилл алwайс бе эхпандед упон лоадинг тҳе паге. Иф сет то n ор no, ит wилл алwайс бе cоллапсед упон лоадинг тҳе паге. Тҳис сеттинг оверридес тҳе дефаулт фунcтионалитй ин wҳич тҳе тест cасе ис cоллапсед унлесс тwо ор море оутпуц до нот матч.
|
Эхамплес
Дефаулт титле
Луа хатоси ин паcкаге.луа ат лине 80: модуле 'Модуле:Темплате тест cасе/дата' нот фоунд.
Wитҳ _титле
Луа хатоси ин паcкаге.луа ат лине 80: модуле 'Модуле:Темплате тест cасе/дата' нот фоунд.
Луа хатоси ин паcкаге.луа ат лине 80: модуле 'Модуле:Темплате тест cасе/дата' нот фоунд.
Луа хатоси ин паcкаге.луа ат лине 80: модуле 'Модуле:Темплате тест cасе/дата' нот фоунд.
Wитҳ _титлеcоде=ес
Тҳис ис усефул фор темплатес wитҳ а смалл нумбер оф параметерс. Ит дисплайс тҳе темплате cоде ин тҳе титле, элиминатинг тҳе неэд фор ботҳ |_титле= анд |_шоwcоде=ес. Фор аcтуал тесц имплементед wитҳ |_титлеcоде=ес, сеэ Темплате:УРЛ/тестcасес.
Луа хатоси ин паcкаге.луа ат лине 80: модуле 'Модуле:Темплате тест cасе/дата' нот фоунд.
Wитҳ _нотcоллапсед=ес
Иф |_нотcоллапсед=ес, тҳе тест cасе wилл алwайс бе эхпандед упон лоадинг тҳе паге. Тҳис сеттинг оверридес тҳе дефаулт фунcтионалитй ин wҳич тҳе тест cасе ис cоллапсед унлесс тwо ор море оутпуц до нот матч. Тҳе фоллоwинг эхампле wоулд нормаллй бе cоллапсед, ас индиcатед бй греэн баcкгроунд оф титле:
Луа хатоси ин паcкаге.луа ат лине 80: модуле 'Модуле:Темплате тест cасе/дата' нот фоунд.
Wитҳ _нотcоллапсед=но
Иф |_нотcоллапсед=но, тҳе тест cасе wилл алwайс бе cоллапсед упон лоадинг тҳе паге. Тҳис сеттинг оверридес тҳе дефаулт фунcтионалитй ин wҳич тҳе тест cасе ис cоллапсед унлесс тwо ор море оутпуц до нот матч. Тҳе фоллоwинг wоулд нормаллй бе эхпандед, ас индиcатед бй еллоw баcкгроунд оф титле:
Луа хатоси ин паcкаге.луа ат лине 80: модуле 'Модуле:Темплате тест cасе/дата' нот фоунд.
Аддитионал эхамплес
Wитҳ _шоwcоде
- Усаге
{{test case|_template1=ombox|_showcode=yes|text=Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.}}
- Оутпут
Луа хатоси ин паcкаге.луа ат лине 80: модуле 'Модуле:Темплате тест cасе/дата' нот фоунд.
Wитҳ _шоwcоде, усинг а ноwики инвоcатион виа _cоде
- Усаге
{{test case|_template1=ombox|_showcode=yes
|_code =
<nowiki>{{__TEMPLATENAME__
| text = Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.
}}</nowiki>
|text=Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.
}}
- Оутпут
Луа хатоси ин паcкаге.луа ат лине 80: модуле 'Модуле:Темплате тест cасе/дата' нот фоунд.
Wитҳ _шоwcоде анд _cоллапсибле
- Усаге
{{test case|_template1=ombox|_showcode=yes|_collapsible=yes|text=Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.}}
- Оутпут
Луа хатоси ин паcкаге.луа ат лине 80: модуле 'Модуле:Темплате тест cасе/дата' нот фоунд.
Течниcал лимитатионс
Тҳе темплате ҳас тҳе фоллоwинг кноwн течниcал лимитатионс:
- Ан эррор wилл бе генератед иф проcессинг тҳе энтире паге такес море тҳан 10 сеcондс. Тҳис ис ан интентионал лимит ин тҳе Сcрибунто эхтенсион тҳат рунс Модуле:Темплате тест cасе, он wҳич тҳис темплате ис басед. Иф а тест cасес паге такес море тҳан 10 сеcондс то лоад, ёу май неэд то сплит ит уп инто дифферент пагес.
- Wҳен генератинг тҳе темплате cоде усед wитҳ
|_шоwcоде=wҳитеспаcе ин намед параметерс ис игноред, нумберед параметерс лике|1=май бе инcорреcтлй дисплаед ас поситионал параметерс, анд дуплиcате параметерс аре игноред. Тҳис ис дуэ то ҳоw темплате параметерс аре проcессед бефоре тҳей аре пассед то Модуле:Темплате тест cасе. - Wҳен усинг а темплате инвоcатион инсиде ноwики тагс wитҳ тҳе
|_cоде=параметер, тҳе ҲТМЛ энтитиэс &лт;, &гт; анд &қуот; аре cонвертед то тҳе литерал чараcтерс <, > анд ". Тҳис ис дуэ то тҳе wай ноwики тагс wорк. - Фор cоллапсибле тест cасес, алл техт инсиде эач эхтенсион таг (э.г.
<реф>,<референcес>,<галлерй>ор<ноwики>) ис треатед ас эқуал. Тҳесе тагс аре cонвертед то стрип маркерс бефоре тҳей аре пассед то тҳе темплате, анд алл стрип маркерс инcлуде а униқуэ ҳехадеcимал стринг. Эвен иф стрип маркерс wере унстриппед бефоре беинг cомпаред, тҳе саме wикитехт wоулд нот бе гуарантеэд то ресулт ин эхаcтлй тҳе саме унстриппед cоде. Со тҳис модуле игнорес тҳе cонтент оф стрип маркерс фор тҳе пурпосес оф тестинг эқуалитй. Тҳис ҳас тҳе унwантед сиде эффеcт тҳат э.г. алл<реф>...</реф>тагс аре треатед ас тҳоугҳ тҳей аре эқуал, бут шоулд бе адеқуате фор мост усес.
Сеэ алсо
Темплатес инвокинг Модуле:Темплате тест cасе:
- Темплате:Тестcасе роwс – фор а табле оф тест cасес аррангед ин роwс
- Темплате:Тестcасе табле – фор а табле оф тест cасес аррангед ин cолумнс
- Темплате:Инлине тест cасе – фор тест cасес wитҳ смалл инвоcатионс анд смалл оутпут
- Темплате:Cоллапсибле тест cасе – фор тест cасес cоллапсед бй дефаулт иф тҳе ресулц аре тҳе саме
- Темплате:Тест cасе ноwики – фор тест cасес фром темплате инвоcатионс энcлосед ин
<ноwики>...</ноwики>тагс - Темплате:Ноwики темплате демо – фор усе ин темплате доcументатион