Bonum Certa Men Certa

Making JavaScript Suck Less

By figosdev

JavaScript source



Summary: "Other than that, the first rule of JavaScript is: Do not use JavaScript. But this article is for people who break the first rule."

First, a disclaimer: this article is not aimed at people making HTML5 games. Milo (Drummyfish) just put out a CC0-licensed game called Anarch, he already likes the suckless philosophy, he made his game work on the browser. Everything he codes is done with care, talent and a serious philosophy. So if you're making HTML5 games, you can be certain this article is not about you.



"This article is about those sorts of considerations, as well as times when JavaScript isn't always bad."Second, for amateurs who are just trying things out, I don't have a problem with your code not being optimised. Keep it simple if you can, do consider people with older machines (try your code on much older machines, if possible) and don't worry about the rest.

And if your JavaScript creates an animated splash screen for anything OTHER than a game? Stop, you're making the Web fucking awful.

Other than that, the first rule of JavaScript is: Do not use JavaScript. But this article is for people who break the first rule.

Fomenteu la lecturaThat's why there is a second rule: Avoid using JavaScript (JS).

I'm sure there are people who think that as long as JS is under a free license, there's no problem with it at all. If JS is under a free license, why even complain? You can change it and share the different version, right?

Not that I go around downloading every program with a free license and running it on my computer, because malware with a free license is still malware. Regardless of the license, I want to control what runs on my computer. Remember when that was the real idea of Free Software?

So JavaScript is off by default. If your website doesn't already work with JS turned off, the clock is ticking before I give up. I might decide it's worth turning it on. I DO like the idea of only running free JS, incidentally; that should remain a goal. But I don't want it to run by default, just because it's free. A lot of the free-as-in-freedom JS out there is crap I don't want running, don't want creating problems, don't want wasting CPU and other resources.

Too many websites use it without a good enough reason, and wherever you draw the line, more consideration needs to go into when people use JS for their websites. This article is about those sorts of considerations, as well as times when JavaScript isn't always bad.

"I especially hate it when everything loads except the buttons that go to the next and previous page. Many websites don't do that, and many do."One question to ask yourself is: did you have enough reason to use JS at all? In other words, did your design really benefit much from the things only JS can do in your particular situation? Techrights is a great example; there is absolutely nothing that Techrights does with JS that I consider useful.

All the functionality (save what WordPress may need, and they used to be more reasonable) that Techrights really needs can be accomplished without JavaScript. The carousel at the front is annoying and unneeded -- I avoid the front page for that and other reasons. Is it easy enough to avoid? Absolutely. Is it a worthwhile use of JS? It's not like we are all going to agree on everything, I get that; but I think this is a perfect example of a superfluous application that can simply be removed.

I really did write this article to talk about JavaScript, not to pick on Techrights, but while we are on the subject Techrights also delivers jQuery to my web browser. Unless it's WordPress that needs that now (a terrible thought, but it wouldn't surprise me at these days) I think Techrights could do just fine without installing any extra JS libraries, particularly ones from GitHub.

I don't expect them to overhaul their entire CMS -- when Techrights chose WordPress about 15 years ago, it was not nearly as much of a mess as it is now. Every version that comes out, WordPress has gotten worse in this regard. But this article is not about overhauling both sides of a website; it is about making simpler changes and simpler choices to begin with.

I get that there are applications that are dynamic and communicate with a server without refreshing. These are my least favourite designs, but there is a place for them. This sort of thing is overdone, but some people are going to make flashy bloated bullshit no matter what. Nobody who insists on that is going to care about the points made here; people who like suckless software might avoid JS altogether, but I think we would benefit substantially from more minimalism -- with or without JS.

"If you can make your website work without JavaScript, you should strongly consider doing so."So if I were in charge, I would remove jQuery (if possible) and just leave WordPress, ditch the carousel even if I have to change a template to get it to work without it. Short of WordPress, I would be trying to remove jQuery along with any JS libraries that could be removed.

If you can make your website work without JavaScript, you should strongly consider doing so. I especially hate it when everything loads except the buttons that go to the next and previous page. Many websites don't do that, and many do.

Using a bloated, complex framework that loads blank pages is another extreme annoyance. I already boycott as many websites that do this as possible. Yes, I still load some of them. What would be better, is if people stopped doing this.

I've even made designs that don't layout properly until JS is enabled -- but the page still loads, it isn't blank. You don't need to turn JS on just to read what it says, and you really shouldn't have to. Sure, perhaps you can come up with a good exception. But the problem is that there are too many exceptions, the problem is that people creating websites just don't care about this.

Just to recap before this article changes its angle altogether:

1. Avoid JS.

2. If you don't manage that, at least keep it minimal.

3. Avoid extra libraries.

4. Make it so that when JS is off, visitors still get something worthwhile -- other than a message to turn JS on.

5. Avoid GitHub -- yes, it has most of the JS libraries; all the more reason.

Additionally, if you can make it so that it's easy (read: "trivial") to download your JS and run it without an Internet connection, do that. Obviously this doesn't apply to designs that sync periodically with the web server.

"The key is to keep it simple and minimalist, while still being dynamic."Here's an example -- you might hate this, but at least it illustrates some of the ideas presented here:

If you have very limited bandwidth, and want to conserve bandwidth for yourself, for visitors or both -- you can make a simple "wiki" in JavaScript so that instead of writing full HTML, you can write text like this:

Here is text.
Here is *bold* text, followed by a blank line:



Here is a link: [url]http://techrights.org[/url]



For three lines of text, you're not saving any bandwidth (or trouble) by not doing something like this instead:




Here is text.<br> Here is *bold* text, followed by a blank line:<br> <br> Here is a link: <a href="http://techrights.org">http://techrights.org</a>



But for an entire website, doing this with a small, single (vanilla) JavaScript file will save you a lot of bandwidth and make your source much easier to edit, read as source, and -- this is why I did it -- easier to parse from the command line without a browser.

If your website is about coding, this can make it much easier to display snippets of code and handle those properly. It is easier to download a single file with code in it, trim the file, and have a usable copy of the code (code other than JavaScript) already.

"JavaScript is still overrated, still overused."If someone loads the page in a browser with JS turned off they will still get the text, but it may all run together. If you don't like HTML, a script like this can make HTML optional, or even let you create your own friendlier alternative (like markdown or bbcode). If you have the ability to use PHP or Python or something else on the server, and this isn't too intensive for the server load you can afford, you can do this in PHP or Python. But if you can't afford to run your code on the server side, small amounts of free JavaScript code can do this.

It can also replace HTML with something that can be parsed and then displayed as formatted text without a browser altogether. For example if the wiki script is very simple, or fairly simple and very popular, you can also have a version of it Python, SML, Raku, or Lua. Then people who download your webpage can pipe it directly through their copy of the offline script, which then makes it do the same things from the command line that it would do from JS -- without some bloated solution like Node.js from GitHub.

The key is to keep it simple and minimalist, while still being dynamic.

Here is another application that I think sucks less: Suppose you want to either teach coding, or create a simple e-book. You might not even have a smartphone because they're evil, but you know your friend has a tablet or an e-reader, maybe they even made their own tablet with a Raspberry Pi. At any rate, they either may not have or don't know how to install an EPUB reader, or they can only do PDF on a fairly small screen -- I have worked on all sorts of ways to do e-books (plain text, HTML, EPUB, PDF) but you want them to be able to download a single file they can read even when they don't have a data connection.

You can do plaintext or everything in a single HTML file, but most people don't want to scroll through a page that long on their phone or tablet. EPUB is a very nice option because you can zoom large without horizontally scrolling/panning on every single line, but maybe they don't like their EPUB reader, or find it complicated, or it only reads files from a directory that is difficult for them to get the file to.

"I would love a more minimalist alternative to the Web, maybe with a more minimalist JavaScript alternative as well."Some PDF readers can wrap text lines, most don't and fewer (if any) free-as-in-freedom PDF readers do -- that's only useful if they can actually install it on their platform --

In my opinion the most reliable way to do an e-book (not the best for every purpose, I know) is to make a VERY simple HTML file with JavaScript included in the same (HTML) file, as opposed to having it download separately.

Then your simple (and free) JS can keep pages small, make it so they can go to the next page, previous page, skip to the next chapter or go to a specific page number; all of this can be done with very little code (even relative to a single chapter, up to a full-length book) and it will run on anything with a browser -- whether downloaded for offline use or simply viewed online.

For smaller, simple applications, this approach also works.

Obviously, it is better for most things to write actual software. JavaScript is still overrated, still overused.

But it is also extremely easy (even without a library) to create an HTML file with a few buttons, add some code to the same file, and have a working program. For a simple application that works online or offline, or for what is absolutely the most beginner-friendly way to create a "gui" application without a lot of skill, familiarity or tedious hacking with library code, vanilla JS makes creating a simple "app" (it will even run on a phone) trivial.

"For the moment, the easiest way to have a subset of Javascript is to simply use less of it."For programs that save or load data, access the system or do a lot of serious work, you're still better off writing something with better tools than what's described here. One of the things I promote is everyone learning how to code -- and I do prefer Python or other things based on Python to JavaScript, but for some purposes JavaScript can be useful.

I believe in subsets as well as minimalism. I would love a more minimalist alternative to the Web, maybe with a more minimalist JavaScript alternative as well.

For the moment, the easiest way to have a subset of Javascript is to simply use less of it. This article focused on examples and recommendations around more modest uses, times in which it is better to avoid JS altogether, and perhaps will inspire someone to create a subset of JavaScript that we can use instead.

"I don't claim that this defines "Suckless" JavaScript; only that it is possible to make JavaScript suck less."I know that "pulling back" like this on technology doesn't always work, but we still often end up with rewards when we try.

I don't claim that this defines "Suckless" JavaScript; only that it is possible to make JavaScript suck less.

Long live rms, and Happy Hacking.

Licence: Creative Commons CC0 1.0 (public domain)

Recent Techrights' Posts

The Campaign to 'End' Richard Stallman - Part II - Scaring People Who Produce Videos in Support of Stallman
There are allegations of threats, defamation, and censorship
 
[Meme] UEFI 'Secure' Boot's Model of Security
Lion cage with people
Climbing a Tall Mountain for 2 Decades
In Web terms, 20 years is a very long time. Very few sites (or a small proportion of the whole) make it to 20.
If You're Going to Concern-Troll "Linux" Make Sure You Actually Use It (Or Tried It)
Concern-trolling has long been a key ingredient of GNU/Linux Fear, Uncertainty, and Doubt
No News Drought in Techrights
Leaving my job after almost 12 years also contributes to available time for research and publication
The Serial Strangler From Microsoft is About to Be Served Court Papers
You can run, but you cannot hide
The Campaign to 'End' Richard Stallman - Part III - The Reddit Mob (Social Control Media Controlled, Steered or Commandeered by Wall Street)
This is totally reminiscent of what authoritarian regimes do
Caged by Microsoft
Are you telling me that preventing people from booting their Linux is security?
Over at Tux Machines...
GNU/Linux news for the past day
IRC Proceedings: Wednesday, May 29, 2024
IRC logs for Wednesday, May 29, 2024
A 3-Year Campaign to Coerce/Intimidate Us Into Censorship: Targeting My Wife
In my view, it is a form of overt sexism
[Chart] Chromebooks in Micronesia Grew at the Expense of Microsoft Windows
As of today...
Linus Torvalds Mocked "Cloud Native" in His Latest Talk (Arguing It's Just Hype), 'Linux' Foundation 'Research' (Marketing) Chooses Proprietary Software to Query Its Adopters
The name "Linux" is overused, abused, even grossly misused
Links 29/05/2024: More Arrests of Regime Critics and Hate Crimes
Links for the day
Brittany Day (linuxsecurity.com) Now Leverages Microsoft Chatbots to Promote Microsoft Propaganda Disguised as "Linux"
What Brittany Day does is an attack both on the Web and on Linux
[Meme] Don't Trust Users to Boot Their Own PCs?
UEFI 'secure' boot
Links 29/05/2024: Hack The Box, Why I Left Healthcare, and Chatbots as Health Risk
Links for the day
Gemini Links 29/05/2024: BESM Retro Second Edition and Itanium Day
Links for the day
Azerbaijan: Microsoft Falls From 99.5% to Almost Nothing or Less Than 20% (Windows Down Sharply, GNU/Linux Surges)
Based on statSounter
Over at Tux Machines...
GNU/Linux news for the past day
IRC Proceedings: Tuesday, May 28, 2024
IRC logs for Tuesday, May 28, 2024
The Campaign to 'End' Richard Stallman - Part I - Two Canceled Talks in a Row?
RMS has left Europe, so the concept of "delayed" talk is facetious or deeply cynical
An "Efficient Windows 11 Experience" is Removing a Text Editor (Less than 5 Megabytes in Size) and Adding Chatbots That Require a New PC/Datacentre
Vista 11 24H2 update removes WordPad
On Desktops/Laptops in Andorra Windows Fell to Less Than Half, 20% If One Counts Mobile as Well
And this is a European country
[Meme] 3 Years Later
If you're going to start a fight, make sure you can handle it
When You Leave a Bad Employer and Move on to Better Things
Perhaps my main mistake was not resigning from my job sooner
No, Your Site Likely Does Not Need WordPress
I was one of the first users of WordPress
GNU/Linux in Cameroon: Rising Steadily While Windows Falls From 99% to Just 6%
If one also counts mobile (mostly Android)
Monkey See, Monkey Share
on deprivation of users
From 0.17% to 10% or More (GNU/Linux in Dominica)
Dominica isn't well known, but it does seem to have embraced Chromebooks in recent years
Links 28/05/2024: Tensions in East Asia, UK Mandatory National Service
Links for the day
Gemini Links 28/05/2024: NetCrawl and Living in Lagrange
Links for the day
Guardian Digital, Inc (linuxsecurity.com) Handed Over Its Web Site to Chatbots That Generate SEO Garbage
They need to be called out on it
statCounter Sees Microsoft Windows at Below 1% in American Samoa
Not even 1%!
Windows Down to 60% of Guam's Desktops/Laptops and Down to a Quarter Overall
No wonder Microsoft is panicking
Today in UEFI 'Secure' Boot Debates (the Frog is Already Boiling and Melting)
Over at LQ today
[Meme] A "Modern" Web's Message in a Bottle
So-called 'security'
Brittany Day: Still Chatbot Slinging, Producing Fake 'Articles' About "Linux"
random garbage produced (and censored) by Microsoft
Almost 4k Gemini Capsules, 5th Anniversary Only Weeks Away
The Web will continue to deteriorate
Microsoft: $1 Million a Day for Contempt of Court Orders (Justice Department)
Microsoft behaves as if it's 100% exempt from laws
Catbodia? In Cambodia, Microsoft's Windows Fell to All-Time Low of Less Than a Quarter.
Cambodia is leaving Microsoft behind
[Meme] Deadnaming
Guess who uses a name that was deprecated well over a decade ago?
[Meme] 'Secure' Boot in a Nutshell
Ask Microsoft if it is "safe" to boot Linux
New Press Report Explains Microsoft Severance and Quiet (Undisclosed) Layoffs
Some people will call this "loophole", whereas others will opine that it is outright illegal (but kept secret to circumvent scrutiny)
Global South is Android/Linux (Windows Era Has Come to an End Already)
I've decided to take a quick glance at South American trends for all operating systems
[Meme] Unified Patent Troll
Unified Patent Court remains illegal and unconstitutional
The European Patent Office is Sinking
Officials (or national delegates) at the European Patent Organisation have long been warned about this (by staff representatives from the European Patent Office), but they ignored the warnings
A 3-Year Campaign to Coerce/Intimidate Us Into Censorship: Targeting Guest Writers (Intimidation)
Some high-profile people have told me that the serial defamer is a "monster" (their word), so why would Neil Brown wish to help him?
Summer in the Air
We have a good pace going on owing to health, positivity, inertia and good software tools
GNU/Linux Activity in Belize
From an economic point of view, Microsoft needn't worry about Belize, but when it comes to preserving the Windows monopoly/monoculture Belize matters
Links 28/05/2024: Back to MP3, NVIDIA Sued by Authors
Links for the day
Gemini Links 28/05/2024: Bad Beach and TLS
Links for the day
Microsoft Windows Fell From 100% to Just 7.5% in Sierra Leone
Based on statCounter
In Benin, Microsoft's Windows Fell Below 10%, GNU/Linux Surged to 6% or Higher on Desktops/Laptops
That's nearly 7% - a lot higher than the average in Africa
Over at Tux Machines...
GNU/Linux news for the past day
IRC Proceedings: Monday, May 27, 2024
IRC logs for Monday, May 27, 2024