Gå till innehållet

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å.

  1. Hämta från python.org
  2. Kör installationsprogrammet
  3. 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

Läs mer om 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
  1. Kontrollera versionen: node --version ska visa 24 eller högre
  2. Rensa cachen: npm cache clean --force
  3. Ta bort node_modules och 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.

Nästa steg