Apple JavaScript Coding Guidelines [pdf]

http://developer.apple.com/library/mac/documentation/ScriptingAutomation/Conceptual/JSCodingGuide/JSCodingGuide.pdf

by tbassetto • 15 years ago

66 25 15 years ago

developer.apple.com

Hovertruck2• 15 years ago

I find it strange that the "Global Scope Considerations" section uses Ruby-style inline comments (#) rather than actual JS inline comments (//).

coyul• 15 years ago

I find it strange that you refer to comments starting with # as Ruby-style comments.

Hovertruck2• 15 years ago

Or any other language that denotes comments with an octothorpe, but I opted for brevity.

chc2• 15 years ago

I'm pretty sure Ruby is bigger than Perl and sh put together now, at least in mindshare.

kreek• 15 years ago

Most of the examples use C style curly braces, maybe Crockford needs to do an "Apple Tech Talk".

http://www.youtube.com/watch?v=hQVTIJBZook

Apocryphon• 15 years ago

Or just read this? http://javascript.crockford.com/code.html

I guess Crockford is like K&R for JS's conventions.

Aqua_Geek• 15 years ago

For those who would prefer an HTML version: http://developer.apple.com/library/mac/#documentation/Script...

scrod2• 15 years ago

Or the actual PDF itself, which lacks the Scribd™ value-added feature of banner ads on every page:

http://developer.apple.com/library/mac/documentation/Scripti...

superchink2• 15 years ago

I think the OP's link is actually to the PDF. HN adds the automatic Scribd link whenever someone posts a link to a PDF.

omgtehlion• 15 years ago

> Just as you used the new

> operator to create an object, you should delete objects when you are finished withthem, like this:

> delete myObjectVariable;

What a bunch of crap? Have these guys even looked at the specs?

And chapter on inheritance really makes me cry...

foobarbazoo• 15 years ago

Man, what a piece of shit. Apple should pull this immediately.

yalogin• 15 years ago

Good that I saw this before reading the pdf. Can you point me to a better resource?

adolph• 15 years ago

As seen elsewhere in the comments, Crockford's is very good:

http://javascript.crockford.com/code.html

jarek-foksa2• 15 years ago

JavaScript Garden is the best collection of JavaScript best practices I have seen so far: http://bonsaiden.github.com/JavaScript-Garden/

lucaswoj2• 15 years ago

I have a strong reason to suspect that this was written by an intern who was relatively new to the language. It seems to be written by someone in the C/C++/Java mindset (ie how they didn't list "function" as a primitive data type)

jarek-foksa2• 15 years ago

Function is not a separate data type in JavaScript, but they could probably list Object there (EcmaScript defines 6 types and 5 primitive values, I can't really find any definition of "primitive type")

lucaswoj2• 15 years ago

The example in this document of using the delete operator on a function is wrong.

http://perfectionkills.com/understanding-delete/

jmreid• 15 years ago

Two years old?

Tomek_• 15 years ago

Already discussed in http://news.ycombinator.com/item?id=1854783 with the same consensus, it's a terrible guide. Read Crockford, Stoyanov, Bolin instead.

blahpro• 15 years ago

It’s shocking that this document refers to "classes". JavaScript doesn’t even have classes.

encoderer• 15 years ago

Why is this comment deprecated? He's absolutely right, if a little late to the party. Shockingly bad document from Apple.

Apple JavaScript Coding Guidelines [pdf]

Related Stories