Error Codes
When the TechUI Guard detects an anomaly, it triggers console warnings or a full-screen meltdown based on the severity of the error.
In the meltdown interface or via the tuiCoreInfo() query, you can view the VALIDSTATUS object. A key value of false indicates that the specific check failed.
Authorization & Expiration
These errors relate to the validity, version, or trial limits of your license.
| Error Code | Meaning | Solution |
|---|---|---|
| dateValid | Primary license expired. System time exceeds the license expDate. | Contact business support to renew and get a new License String. |
| subLicDateValid | Sub-license expired. The developer license distributed to the end customer has expired. | Generate a new sub-license string for the customer. |
| tempKey | Trial time exhausted. Advanced components used in free/trial mode; 10-minute countdown ended. | Refresh the page to reset the timer or purchase a formal license. |
| version | Version incompatibility. Library version (e.g., v1.5) is higher than the license version constraint (e.g., v1.0). | 1. Upgrade license; 2. Downgrade library to a supported range. |
Environment & Binding
Triggered when the running environment does not match the license configuration.
| Error Code | Meaning | Solution |
|---|---|---|
| domainName | Domain validation failed. Current hostname is not in the license whitelist. | Check deployment domain or contact support to add the domain to the whitelist. |
| project | Project name mismatch. projectBind is enabled, but document.title does not contain the required project name. | Update the HTML <title> tag to include the project name specified in the license. |
| deployLocation | Deployment violation. License restricted to localOnly (intranet), but public network detected. | Ensure deployment is on intranet IPs or private clouds, or upgrade to a general license. |
| platform | Platform type error. Running TechUI Prime on TechUI Sass (or vice versa). | Ensure the library version matches the purchased platform type. |
Integrity & Anti-Tampering
Indicates potential attacks or environmental damage detected by the system.
| Error Code | Meaning | Solution |
|---|---|---|
| nativeMethods | Native methods tampered. Browser APIs (e.g., console.info, Date) hooked or modified by third-party scripts. | 1. Disable interfering browser plugins; 2. Check if third-party monitoring SDKs rewrote native objects. |
| comment | Signature node missing. The TechUI authorization comment at the end of the HTML was removed. | Do not use JS scripts to remove HTML comments; this is a mark of legitimate authorization. |
| webSys | Host environment anomaly. Wasm cannot access window or document objects. | Check for unsupported browsers or non-standard WebViews. |
| icoreStr | Core integrity compromised. Wasm internal core string constants were illegally modified. | Serious error usually caused by memory debuggers. Refresh the page. |
| component | Component validation failed. Detected component tampering. | Usually caused by malicious code modification. |
Parsing & Format
Usually implies the input License string itself is corrupted.
| Error Code | Meaning | Solution |
|---|---|---|
| license | Primary license parsing failed. Format error, truncated, or signature check failed. | Re-copy the full License string from the email, ensuring no extra spaces. |
| subLicense | Sub-license parsing failed. Sub-authorization segment format error. | Check if the generated sub-license configuration is correct. |
Prime Edition Exclusive
The following errors appear only when using the @techui/prime flagship edition.
| Error Code | Meaning | Solution |
|---|---|---|
| licenseKey | License key not found. | Check if the license key was passed. |
| licenseDec | License key parsing error. | Check if the license key is correct. |
| keychain | Keychain missing. | Execute npm install @techui/prime-keychain and ensure correct import. |
| keyInChain | No matching key in keychain. | Check the keychain parameter in the initialization code. |
| configParams | Configuration decryption failed. | Ensure Client Key and Keychain versions match. |
| licCfgParams | Error in config key parameters. | Check if config parameters match the license key parameters. |
| environment | Production environment limit. NODE_ENV=production detected in unauthorized mode. | Prime edition prohibits production builds without authorization. Configure a formal license. |
TIP
Quick Positioning: Type tuiCoreInfo() in the dev console to view the VALIDSTATUS object. Any item marked false is the cause of the meltdown.