Appearance
Klai Error Codes
Klai Studio can throw various errors due to code or configuration. Errors can appear in the Helper File, Developer Tools ( when enabled) or the browser console.
| Error Code | Description | Other information passed |
|---|---|---|
| 400 | Bad request | Issue could be related with a broad types of errors. Most common would be trying to access wrong FM file, invalid credentials |
| 401 | Authentication | Issue when user is not authenticated and tries to load an authenticated form or invalid credentials are set to access the Helper File |
| 404 | Page not found | Issue in base code or Feathers where form ID is incorrect, navigation slug or service doesn't exist. |
| 406 | OAuth provider not configured | Feathers NotAcceptable when OAuth login starts for a provider that has no credentials in the connection OAuth vault (Google, Auth0, Okta, or Microsoft). Turning on Enable 3rd Party Authentication is not enough — the specific provider must be configured. Response message looks like: OAuth provider "Microsoft" is not configured. This is not FileMaker error 406. |
| 408 | Timeout | FileMaker scripts taking longer than 20 seconds to return requests. The behavior has changed in base code v2.1+ and is a warning only. |
| 959 | Technology not available | Issue in FileMaker server when, for example, XML gateway is unavailable or not enabled. |
| 952 | Invalid Data API | Issue with communication between Feathers and FileMaker server when a user is using a session with the Data API gateway that's invalid for the FM database (e.g. hard reset of FM database or manually disconnected clients from FM database). |
| 10xxx Series | Errors generated within client (browser) side code | |
| 100xx | Site Related | |
| 10010 | DOM Header insertion error, There was an error with adding content to the <head> tag. Usually a JS error or resource error | script content and error |
| 10020 | HTML Render error | |
| 10030 | Custom component not found. | Component name |
| 10040 | Vue warning captured | error info |
| 10042 | Vue Error captured | error info |
| 10050 | Site not found | Issue when no site record is found for domain, while creating routes for app. |
| 101xx | Action Related | |
| 10100 | No action handler found for the passed action. Check action name. | The action |
| 10110 | namedAction not found, Klai tried to look for the named action in the for and site and was unable to find it. | The action that caused the issue |
| 10112 | No action handler found for action | Issue in Klai app where an invalid Klai action was called |
| 10120 | No onResponse_actions has been configured. This is used on elements that have callbacks like payment gateways. | The response the element tried to handle |
| 10130 | Missing channel | Issue in Klai app where a channel key is not passed when adding or removing a user to an anonymous channel. |
| 10131 | Channels must be an array | Issue in Klai app where channels is not an array when sending a message. |
| 10132 | Message error | Issue in Klai app when sending a message (e.g. user not authorized to send message on authenticated channel, user not added to any authenticated |
| 10140 | Missing path or URL | Issue in Klai app when using the action path and no path or url is specified. |
| 10141 | Duplicated Navigation path | Issue in Klai app when using the action path and the path action tries to navigate to current page. |
| 10150 | Invalid Login Attempt | Wrong password (Invalid login) or unknown email (No records found). Auth feedback code auth.invalid_login. A disabled account is 10163, not 10150. |
| 10151 | Logout action error | Issue with logout action. |
| 10152 | Signup action error | Issue when user tries to signup. (e.g. email already registered) |
| 10153 | Password reset hook error | Issue when sending a reset password link. |
| 10154 | Password reset action error | Issue when resetting the password. |
| 10155 | Resend verify signup error | Issue when sending a link to verify user's email. |
| 10156 | Verify signup error | Issue when verifying user's email. |
| 10157 | On login hook error | Issue when user tries to login. Error caused by, most likely, some backend (FM) issue. |
| 10158 | OAuth on login hook error | Issue when user tries to login via OAuth. Error caused by, most likely, some backend (FM) issue. |
| 10159 | BF.namedAction invalid parameter | Issue when string passed as parameter for BF.namedAction function does not translate to a valid JSON object. |
| 10160 | OAuth login error returned from external provider | Issue when trying to login via OAuth with external provider. Auth feedback code auth.oauth_failed. A disabled account during OAuth is 10163, not 10160. |
| 10161 | Magic link request error | Issue when requesting a magic sign-in link. Auth feedback code auth.magic_link_request_failed. |
| 10162 | Invite complete error | Issue when completing an invite. A bad, expired, or disabled invite keeps the server sentence Token is invalid or expired. Auth feedback code auth.invite_complete_failed. |
| 10163 | Account disabled | Local login or OAuth passed the credential check, then the server reported the account disabled. Auth feedback code auth.account_disabled. The server sentence is kept, for example name - account disabled. Wrong password and unknown email stay on 10150. |
| 10170 | Local / Session Storage Error | Error while retrieving Local or Session storage data |
| 10171 | Local / Session Storage Error | Error while writing data to Local or Session storage. |
| 102xx | Calculation Related | |
| 10200 | Error when evaluating *_calc field | Issue when there's an error with the expression passed to a field *_calc. (It doesn't include fields visible nor validator). |
| 10201 | Error when evaluating *_calc or *_calcf field | Issue when there's an error with the expression passed to a field *_calc. (It includes fields visible nor validator). |
| 10202 | Error when evaluating *_actions field | Issue when there's an error with the expression passed to a field *_actions. |
| 10203 | Error when evaluating *_function field | Issue when there's an error with the expression passed to a field *_function. |
| 105xx | Function Action Related | |
| 10501 | Error in function action JavaScript | Thrown when user-supplied JavaScript inside a function action throws an error at runtime. The error message includes the action name (or action type) and the original error. The third argument is a structured object containing: action (action type), name (action name if set), functionSnippet (first 200 chars of the JS), stack (full stack trace), and options (the action's options object). |
| 103xx | Hook Related | |
| 10300 | Unhandled Form hookset type | Issue returned from FileMaker business file caused by not handled utility hook type. |
| 10301 | Error Updating Environment record | Issue returned from FileMaker when trying to update an Environment record. |
| 10302 | Error Updating Site | Issue returned from FileMaker when trying to update a Site record (hash5L field doesn't exist). |
| 10900 | Other | |
| 10901 | DAPI Adapater Error | Issue thrown by the DAPI adapter in our base code. |
| 10902 | Client is offline | User has no internet connection. |
| 10903 | Unable to get DAPI token | Issue thrown by the DAPI adapter in our base code when base code was unable to retrieve a valid DAPI token. |