Fejlesztői proxy konfigurálása
A fejlesztői proxy nagy mértékben konfigurálható.
beépülő modulokat a funkciók implementálásához. Kombinálhatja bármelyik standard beépülő modult és , hogy felépíthesse a saját-at. Beépülő modulok és egyéni konfigurációk használatával testre szabhatja a Dev Proxyt az ön igényeihez. A fejlesztői proxy egy alapértelmezett konfigurációs fájlt tartalmaz, amely devproxyrc.json
. A fájl a Dev Proxy telepítési mappájában található.
Borravaló
Javasoljuk, hogy egyéni konfigurációs fájlokat hozzon létre. Egyéni konfigurációs fájlok használatával egyszerűen válthat a különböző konfigurációk között, és belefoglalhatja őket a forrásvezérlő rendszerbe a projekt kódjával együtt. A konfigurációnak a projekttel való tárolása megkönnyíti a csapattal való megosztását is.
Ha devproxyrc.json
vagy devproxyrc.jsonc
nevet ad a konfigurációs fájlnak, a Dev Proxy automatikusan betölti azt az aktuális könyvtárból, amikor elindítja. Más neveknél adja meg a fájl elérési útját a --config-file
argumentumban a Dev Proxy indításakor, például devproxy --config-file ./my-devproxy-config.json
.
Konfigurációs fájlstruktúra
Az alábbi kódrészlet az alapértelmezett Dev Proxy konfigurációs fájlt jeleníti meg:
{
"$schema": "https://raw.githubusercontent.com/dotnet/dev-proxy/main/schemas/v0.24.0/rc.schema.json",
"plugins": [
{
"name": "RetryAfterPlugin",
"enabled": true,
"pluginPath": "~appFolder/plugins/dev-proxy-plugins.dll"
},
{
"name": "GenericRandomErrorPlugin",
"enabled": true,
"pluginPath": "~appFolder/plugins/dev-proxy-plugins.dll",
"configSection": "genericRandomErrorPlugin"
}
],
"urlsToWatch": [
"https://jsonplaceholder.typicode.com/*"
],
"genericRandomErrorPlugin": {
"errorsFile": "devproxy-errors.json"
},
"rate": 50,
"logLevel": "information",
"newVersionNotification": "stable",
"showSkipMessages": true,
"showTimestamps": true
}
A konfigurációs fájl három szakaszból áll:
- A
$schema
tulajdonságban definiált séma. Annak érdekében, hogy a konfigurációs fájl érvényes legyen, mindenképpen ugyanazt a sémaverziót használja, mint a használt Dev Proxy-verzió. - A Dev Proxy által használt beépülő modulok listája a
plugins
tömbben definiálva. - Általános konfigurációs beállítások.
Fontos
A Dev Proxy a konfigurációs fájlban felsorolt sorrendben alkalmazza a beépülő modulokat. Ügyeljen a kívánt viselkedés elérésének sorrendjére.
Egyes beépülő modulok konfigurálhatók, és saját beállításokat tehetnek közzé. Minden beépülő modulnak saját konfigurációs szakasza van a konfigurációs fájlban, amelyet a beépülő modul definíciójának configSection
tulajdonsága hivatkozik. Az egyes beépülő modulok referenciadokumentációjában további információt talál a beépülő modulok konfigurációs beállításairól.
Borravaló
A configSection
tulajdonság értéke bármilyen sztring lehet. Különböző nevek használatával több példányt is megadhat ugyanabból a beépülő modulból, és mindegyik más konfigurációval rendelkezik. Előfordulhat, hogy többször is hivatkoznia kell ugyanarra a beépülő modulra, például ha több API-t szimulál különböző hibaválaszokkal és viselkedésekkel.
Fejlesztői proxyeszközkészlet
Dev Proxy Toolkit egy Visual Studio Code-bővítmény, amely jelentősen leegyszerűsíti a Dev Proxy konfigurálását. Íme néhány funkció, amely a következőket tartalmazza:
- kódrészletek gyakori konfigurációs forgatókönyvekhez
- kiterjesztett linting és IntelliSense a fejlesztői proxy konfigurációs fájlokhoz
- egyéni szerkesztőműveletek és parancsok a fejlesztői proxy kényelmes indításához és leállításához
- értesítések a Dev Proxy új verzióiról
Borravaló
A Visual Studio Code használata esetén javasoljuk, hogy telepítse a Dev Proxy Toolkit bővítményt.
Következő lépés
Ha folyamatosan szeretné megismerni a Dev Proxy használatát, fontolja meg az alábbi oktatóanyagokat:
- Saját alkalmazás véletlenszerű hibáinak szimulálása
- JavaScript ügyféloldali webalkalmazás tesztelése, amely meghívja a Microsoft Graph
- JavaScript ügyféloldali webalkalmazás tesztelése
Egyébként tekintse meg a hogyan használati útmutatókat, hogy megtanulja, hogyan használhatja a Dev Proxyt adott forgatókönyvekhez.