Strange behavior in a possible way to comment

Question

I have two functions

/########### CARREGAR - LANÇAMENTO ###########/
var carregar_parametros=function(){
    alert('asd');
}
/########### CADASTRAR - LANÇAMENTO ###########/
var cadastrar_parametro=function(){
    if($("#lancamento").val()!=''){
        UiLoading.show();
        $.post('/paginas/teste/cadastrar_parametro',{
            lancamento:$("#lancamento").val(),
            tipo:$("#tipo").val(),
            ativo:$("#lancamento_ativo").attr('checked')=='checked' ? '1' : '0'
            },function(){
                carregar_parametros();
                UiLoading.hide();
                $("#cancelar_parametro").click()
                UiAlert('Parâmetro cadastrado com sucesso!','Atenção');
        });
    }else{
        UiAlert('Por favor, preencha os campos nulos!','Atenção');
    }
}

when I do the job cadastrar_parametro with the comment /########### CADASTRAR - LANÇAMENTO ###########/ there is no mistake but when I do the function carregar_parametros with the same style of comment it gives error

Uncaught Syntaxerror: Unexpected token ILLEGAL

And when I test the extension firebug from Firefox he shows me this

Syntaxerror: illegal Character /########### REGISTER - RELEASE

#####/

What can it be?

Answer 1

Responding more directly:

A Javascript comment is written as follows:

// Isso é um comentário.
/* Ou isso também é */

You can find more details in any book or reference you want.

About specifically your code, you have it here:

/########### CARREGAR - LANÇAMENTO ###########/

This is the syntax for declaring a regular expression. /isso é uma regex/. This is an object that can be put into a variable, in the same way as a number or a string. It doesn’t do anything the way that code does nothing:

4

The error problem is in semicolons. Note:

var carregar_parametros = function() {/* ... */}

What you are doing is the same as by a value (the function) in a variable. Semantically it is the same as:

var a = 5

But you didn’t put semicolon at the end! This is a syntax error:

var a = 5
/regex/

For it is read thus:

var a = 5/regex/

Add a semicolon at the end of the resolve function statement. But honestly... use true comments!

Answer 2

Just adding to comments that have already responded to Javascript comment formats, look for code writing standardization (coding standards), which makes it easy for you or anyone else to maintain the code.

See that:

//###### CADASTRAR LANÇAMENTO ####### //
var funcao = function () {};

It may seem like a good highlight in the code to separate the different functions, but a comment in the style "JAVADOC" can be much more useful and elegant, mainly by being widely used:

/**
 * Carrega a UI e efetua o cadastro de um lancamento.
 * @return void
 */
var funcao = function () {};

Answer 3

No Javascript use // for one line comments and /* (...) */ for comments of 2 or more lines.

View documentation.

Answer 4

You may be using / / for a single line and /* */ for multiple lines for comments on Javascript.

// Comentário de uma linha

/*
   Comentário com
   Múltiplas
   Linhas
*/

_{Comment Statements}

Even no semicolon is required at the end of a function, I believe that if you used it you would avoid the error already explained in the @Guilherme Bernal’s reply.

/########### CARREGAR - LANÇAMENTO ###########/
var carregar_parametros=function() {}; // <--
/########### CADASTRAR - LANÇAMENTO ###########/
var cadastrar_parametro=function() {}

Answer 5

You should use the comments:

/* */ or //

And it’s not good to use / #### ... ### / because this is a regex. I hope I’ve helped.