Installation på lokal maskin
Den här vägen passar dig som vill
- testa webbplatser som inte är publika, till exempel en acceptansmiljö,
- bidra till utvecklingen av Webperf Core, eller
- ha full kontroll över testmiljön.
Förutsättningar
Python 3.13 eller senare
Det är kravet i projektets egen installationsguide, och den version samtliga regressionstester körs på.
- Hämta från python.org
- Kör installationsprogrammet
- Viktigt: kryssa i "Add Python to PATH"
brew install python@3.13
sudo apt update
sudo apt install python3 python3-venv python3-pip
Node.js 24 eller senare
Hämta från nodejs.org.
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt install -y nodejs
Webbläsare
Installera minst en av Google Chrome och Mozilla Firefox. Chrome är standard; byt med --setting tests.sitespeed.browser=firefox.
Installation
1. Hämta koden
# Ska du bidra: forka först på GitHub och klona din fork
git clone https://github.com/DITT-ANVANDARNAMN/webperf_core.git
# Annars räcker originalet
git clone https://github.com/Webperf-se/webperf_core.git
cd webperf_core
2. Skapa en virtuell miljö
python -m venv venv
Aktivera den:
venv\Scripts\activate
.\venv\Scripts\Activate.ps1
source venv/bin/activate
3. Installera beroenden
python -m pip install --upgrade pip
pip install -r requirements.txt
npm install --omit=dev
4. Validera installationen
python default.py --dependency
Kommandot kontrollerar att Python-paket, Node-paket och webbläsare finns på plats och rapporterar vad som fattas.
Kör ditt första test
python default.py -u https://webperf.se -t 22 -r
Konfiguration
Tillfälliga inställningar
--setting (kort form -s) ändrar en inställning för just den körningen:
python default.py -u https://example.com -t 15 -r \
--setting tests.sitespeed.browser=firefox
Lista alla inställningar med deras nuvarande värden:
python default.py --setting ?
Permanenta inställningar
Skapa settings.json i projektets rot med bara det du vill ändra:
{
"general": {
"language": "sv",
"review": {
"show": true,
"details": true
}
}
}
Vill du utgå från din nuvarande uppsättning kan du skriva ut den till fil:
python default.py --save-setting settings.json
Felsökning
Python hittas inte
Windows: Python ligger inte i PATH. Installera om och kryssa i "Add Python to PATH".
macOS/Linux: prova python3 i stället för python.
pip install misslyckas med rättighetsfel
Använd en virtuell miljö (steg 2). Går inte det, installera för din användare:
pip install --user -r requirements.txt
npm install misslyckas
- Kontrollera versionen:
node --versionska visa 24 eller högre - Rensa cachen:
npm cache clean --force - Ta bort
node_modulesoch försök igen
Chrome eller Firefox hittas inte
Se till att webbläsaren är installerad och finns i systemets PATH. På Linux kan du behöva extra beroenden:
sudo apt install -y chromium-browser firefox
Test 31 (Webbkoll) misslyckas
Testet kräver att en webbkoll-backend är igång. Kontrollera att den svarar på adressen i tests.webbkoll.api-url, som standard http://localhost:8100.
Test 20, som anropade den publika tjänsten, är pensionerat.
Test 32 (DNS) gör ingenting
DNS-testet kör Zonemaster i en Docker-container. Utan Docker igång kan testet inte köras.