---
title: "Skriptfehler und Fehlerbehebung"
description: "Fehler in TapHome-Skripten beheben: Line in script: 1 Message: Division by zero, Unknown variable or constant, Wrong number of literals and operators, PARSETEXT out of range, function not supported here."
url: "https://taphome.com/de/docs/script/errors/"
language: de
lastmod: 2026-10-26
generator: hugo
ai:
  topics: ["scripting-language","script-errors","troubleshooting","division-by-zero"]
  questions: ["Wie behebe ich in einem TapHome-Skript den Fehler \"Line in script: 1 Message: Division by zero\"?","Wie teile ich zwei Variablen (va1/va2) sicher und wende die Formel nur an, wenn der Nenner größer als 0 ist?","Was bedeutet \"Unknown variable or constant\" in einem TapHome-Skript?","Warum ergibt \"1 == 1\" den Fehler \"Wrong number of literals and operators in expression\"?","Warum hält PARSETEXT das Skript mit \"Specified argument was out of the range of valid values.\" an?","Warum erhalte ich \"ADDERROR function not supported here.\"?","Was bedeutet \"Please update your core unit to be able to use this feature\"?","Wie werden Laufzeitfehler eines TapHome-Skripts gemeldet?"]
---

# Skriptfehler und Fehlerbehebung

Fehlermeldungen der TapHome-Skripte im genauen Wortlaut — Division by zero, Parserfehler, Laufzeitfehler sowie Kontext- und Versionsfehler — jeweils mit Ursache und Behebung.

Zuletzt aktualisiert: 2026-10-26

Ein TapHome-Skript kann auf zwei Arten fehlschlagen. Ein **Parserfehler** wird beim Einlesen des Skripttextes gefunden: Der Skripteditor zeigt ihn an, und das Skript läuft nicht. Ein **Laufzeitfehler** hält ein Skript an, das bereits läuft. Die folgenden Meldungen sind im genauen Wortlaut zitiert; `X`, `A`, `B` und `N` stehen für den Namen, den Typ oder die Zahl in der Meldung.

## Wie Fehler gemeldet werden

Ein Laufzeitfehler enthält die Zeile des Skripts und die Meldung:

```text
Line in script: 7
Message: Division by zero
```

Wo der Zeilenumbruch nicht angezeigt wird, lautet derselbe Fehler `Line in script: 7 Message: Division by zero`. Ein durch einen Laufzeitfehler angehaltenes Skript liefert keinen Wert (`Null`); eine smart rule Formel hat dann bei ihrem nächsten Durchlauf auch `LastState` = `Null`.

## Division durch null

`Line in script: 1 Message: Division by zero` bedeutet, dass ein Divisor beim Lauf des Skripts genau 0 war — typischerweise ein Gerätewert wie `va2` in `va1/va2`. Teilen Sie nur, wenn der Divisor größer als 0 ist:

```taphome
IF(va2 > 0, va1/va2, 0);
# Result: 0 when va2 is 0, otherwise va1 divided by va2
```

Die Funktionsform von `IF` wertet nur den gewählten Zweig aus und teilt daher nie durch 0. Verwenden Sie `va2 <> 0`, wenn der Divisor negativ sein kann. Weitere Rezepte unter [Beispiele](https://taphome.com/de/docs/script/examples/#safe-division).

## Parserfehler

| Meldung | Ursache und Behebung |
|---|---|
| `Unknown variable or constant 'X'` | Ein Tippfehler, ein Gerätewert, der dem Skript nicht hinzugefügt wurde, oder ein Wort, das die Sprache nicht kennt: `NOT 1` ergibt `'NOT'` — die Negation ist `!`. Außerhalb eines Blocks kann sich ein fehlendes `;` in der vorherigen Zeile als der nächste Name zeigen. |
| `Unknown function 'X'` | Diese Funktion gibt es nicht. `MODBUS`, `TOBYTEARRAY` und `BYTEARRAY` existieren nicht — verwenden Sie `MODBUSR` oder `MODBUSW`, `TOBYTES` und `BYTECOLLECTION`. |
| `Wrong number of literals and operators in expression` | Ein Operator ohne Operand, zum Beispiel `1 == 1`. Gleichheit ist `=`, Ungleichheit `<>`. |
| `Unexpected character 'X' at the end of statement.` | Das `;` vor der nächsten Anweisung fehlt. Innerhalb eines Blocks endet die Meldung mit `Expected ';'`, zum Beispiel `Unexpected character 'E' at the end of statement. Expected ';'` vor `END`. |
| `Unexpected character '.'` | Eine Eigenschaft wird aus einem Funktionsergebnis gelesen, etwa `AVG(1, 2).Type`. Speichern Sie den Wert zuerst in einer Variablen. |
| `Unexpected character ';' in WHILE statement` (oder `DO`) | Ein `;` nach einem inneren `END` oder `LOOP` innerhalb einer Schleife. |
| `Unexpected keyword 'X' at the end of IF statement.` | Ein `;` nach einem inneren `END` innerhalb eines `IF`-Blocks. |
| `Comment must start on a new line and inline comments are not supported` | Ein `#` vor dem `;` einer Anweisung oder nach einer `IF`- oder `WHILE`-Bedingung. |
| `Comparison with NaN is always false. Use the IsNaN method to check for NaN value.` | `x = NaN` — verwenden Sie `ISNAN(x)`. |
| `Couldn't unescape X` | Ein einzelner Backslash in einem String; schreiben Sie `"C:\\data"`. |
| `Too many characters in char literal` | Text in einfachen Anführungszeichen, etwa `'ab'`; Text braucht doppelte Anführungszeichen. |
| `Variable name must start with letter`, `Only letters or numbers are allowed in variable name` | Ein Name wie `1x` oder `my_value`. |
| `Variable must have initial value provided` | `VAR x;` — geben Sie einen Wert an oder deklarieren Sie einen Typ: `int x;`. |

## Laufzeitfehler

| Meldung | Ursache und Behebung |
|---|---|
| `Division by zero` | Siehe [Division durch null](https://taphome.com/de/docs/script/errors/#division-by-zero). |
| `Specified argument was out of the range of valid values.` | `PARSETEXT` hat das linke Muster gefunden, das rechte aber nicht. Prüfen Sie zuerst mit `INDEXOF`. |
| `PARSEJSON - Element not found: 'X'` | Der JSONPath hat nichts gefunden. Übergeben Sie `TRUE` als drittes Argument, um stattdessen `Null` zu erhalten. |
| `Operator 'X' not defined for 'A' and 'B'` | Eine Operation mit inkompatiblen Typen, zum Beispiel Arithmetik mit `Null`. Prüfen Sie zuerst mit `ISNULL`. |
| `Cannot cast 'A' to 'B'` | Ein Wert eines Typs, der nicht umgewandelt werden kann, zum Beispiel Text, wo eine Zahl erwartet wird. |
| `Can not directly set value to device variable` | Eine Zuweisung an einen Gerätewert außerhalb einer smart rule Skript. |
| `More than 1 000 000 loops, stopping loop` | Eine `WHILE`- oder `DO`-Schleife, die nicht endet. |
| `Cannot use BREAK() outside of WHILE or DO-WHILE` | `BREAK` außerhalb einer Schleife; ebenso `CONTINUE`. |
| `Interval 'X' is out of range (0-10000)` | `SLEEP` mit einem negativen Intervall oder länger als 10 000 ms. |
| `Maximum array length is 2048` | `BYTECOLLECTION` aus einem hexadezimalen Text mit mehr als 2048 Bytes. |
| `Invalid array length. Must be greater than 0 and less than or equal 2048` | `BYTECOLLECTION` mit einer Anzahl von 0 oder mehr als 2048 Bytes. |
| `UINT16COLLECTION: count must be between 1 and 2048` | `UINT16COLLECTION` oder `BOOLCOLLECTION` (mit eigenem Namen in der Meldung) mit einer Anzahl außerhalb von 1 – 2048. |
| `GETBIT - bit must be between 0 and 15` | Ein Bit oder Byte außerhalb des Typs des Wertes, hier eines 16-Bit-Wertes. |
| `GETBIT - value X is out of the 32-bit range (-2147483648 .. 4294967295)` | Ein Dezimalwert, der keine 32-Bit-Ganzzahl ist. |
| `Return value 'X' does not match required return type constraint: 'T'` | Ein Leseskript eines Geräts hat einen Typ zurückgegeben, den der Gerätewert nicht aufnehmen kann. |
| `Response is too long (Nbytes). Maximum supported length is 128KB` | Eine HTTP-Antwort größer als 128 kB. |
| `Invalid register number: X` | Ein Modbus-Register außerhalb von 0 bis 65535. |
| `RegisterValueToWrites: Can't write double.NaN to modbus register` | Mit `MODBUSW` geschriebenes `NaN`. |

Die Meldungen der Verschlüsselungs-, Hash- und Byte-Kodierungsfunktionen, zum Beispiel `AESDECRYPT - decryption failed, check the key, the iv and the padding` oder `FROMHEX - invalid hex digit 'x'`, stehen bei jeder Funktion unter [Verschlüsselung und Hashes](https://taphome.com/de/docs/script/encryption-and-hashes/) und [Byte-Kodierungen und Prüfsummen](https://taphome.com/de/docs/script/byte-encodings/).

## Kontext- und Versionsfehler

| Meldung | Ursache und Behebung |
|---|---|
| `X function not supported here.` | Die Funktion funktioniert in dieser Art von Skript nicht, zum Beispiel `ADDERROR function not supported here.` in einer smart rule. |
| `SLEEP function not allowed in this context.` | `SLEEP` in einer smart rule Skript oder in einem Benachrichtigungsskript. |
| `ModbusFunction - unknown modbus device to work with` | Eine Modbus-Funktion außerhalb eines Modbus-Skripts. |
| `PacketParserFunction - PacketParserContext is null` | Eine Packet-Parser-Funktion außerhalb eines Packet-Parser-Skripts. |
| `DEBOUNCE - invalid argument, must be a device variable` | Das erste Argument von `DEBOUNCE` ist ein Ausdruck, kein Gerätewert. |
| `DEBOUNCE - Function is not available` | `DEBOUNCE` in einem Skript ohne Gerätewerte, die entprellt werden können. |
| `X function not supported. Please update your core unit to be able to use this feature.` | Die Core-Version ist älter als die Funktion. |
| `Data type 'X' not supported. Please update your core unit to be able to use this feature.` | Ein Typ-Schlüsselwort, das neuer ist als die Core-Version. |
| `Modbus data type 'X' not supported. Please update your core unit to be able to use this feature.` | `Int64`, `UInt64` oder `Double` auf einer älteren Core-Version; sie erfordern TapHome Next 2026.1.40665+. |

Welchen Build jede Funktion benötigt, steht unter [Versionsanforderungen](https://taphome.com/de/docs/script/version-requirements/).
