Jak zdefiniować zmienne globalne w CoffeeScript?

Na Coffeescript.org:

bawbag = (x, y) ->
    z = (x * y)

bawbag(5, 10) 

skompilowałby się w:

var bawbag;
bawbag = function(x, y) {
  var z;
  return (z = (x * y));
};
bawbag(5, 10);

kompilacja za pomocą skryptu kawy pod opakowaniami node.js, które:

(function() {
  var bawbag;
  bawbag = function(x, y) {
    var z;
    return (z = (x * y));
  };
  bawbag(5, 10);
}).call(this);

Dokumenty mówią:

Jeśli chcesz utworzyć zmienne najwyższego poziomu do użycia dla innych skryptów, dołącz je jako właściwości w oknie lub w obiekcie eksportu w CommonJS. Operator egzystencjalny (omówiony poniżej) daje niezawodny sposób, aby dowiedzieć się, gdzie je dodać, jeśli celujesz zarówno w CommonJS, jak i przeglądarkę: root = eksportuje? to

Jak zdefiniować zmienne globalne w CoffeeScript. Co oznacza „dołącz je jako właściwości do okna”?

Ponieważ skrypt kawy nie ma varinstrukcji, automatycznie wstawia ją do wszystkich zmiennych w skrypcie kawy, w ten sposób zapobiega wyciekaniu skompilowanej wersji JavaScript do globalnej przestrzeni nazw .

Ponieważ więc nie ma sposobu, aby coś „wyciekło” do globalnej przestrzeni nazw od strony skryptów kawy celowo, musisz zdefiniować swoje zmienne globalne jako właściwości obiektu globalnego .

dołącz je jako właściwości do okna

Oznacza to, że trzeba zrobić coś podobnego window.foo = 'baz';, który obsługuje sprawy przeglądarki, ponieważ tam globalny obiekt jest window.

Node.js

W Node.js nie ma windowobiektu, zamiast tego jest exportsobiekt przekazywany do opakowania, które otacza moduł Node.js (patrz: https://github.com/ry/node/blob/master/src/node.js# L321 ), więc w Node.js musisz zrobić exports.foo = 'baz';.

Teraz rzućmy okiem na to, co mówi w cytacie z dokumentów:

... atakując zarówno CommonJS, jak i przeglądarkę: root = eksportuje? to

Jest to oczywiście skrypt do kawy, więc przyjrzyjmy się temu, co to właściwie kompiluje:

var root;
root = (typeof exports !== "undefined" && exports !== null) ? exports : this;

Najpierw sprawdzi, czy exportsjest zdefiniowany, ponieważ próba odwołania się do nieistniejącej zmiennej w JavaScript dałaby w przeciwnym razie błąd SyntaxError (z wyjątkiem sytuacji, gdy jest używana z typeof)

Więc jeśli exportsistnieje, co ma miejsce w Node.js (lub w źle napisanej witrynie WebSite ...), root wskaże exports, w przeciwnym razie this. Co to jest this?

(function() {...}).call(this);

Użycie .callna funkcji spowoduje powiązanie thiswnętrza funkcji z pierwszym przekazanym parametrem, w przypadku przeglądarki thisbędzie teraz windowobiektem, w przypadku Node.js globalnym kontekstem, który jest również dostępny jako globalobiekt.

Ale ponieważ masz requirefunkcję w Node.js, nie ma potrzeby przypisywania czegoś do globalobiektu w Node.js, zamiast tego przypisujesz exportsobiekt, który następnie jest zwracany przez requirefunkcję.

Kawa-skrypt

Po tych wszystkich wyjaśnieniach oto, co musisz zrobić:

root = exports ? this
root.foo = -> 'Hello World'

Spowoduje to zadeklarowanie naszej funkcji foow globalnej przestrzeni nazw (cokolwiek się stanie).
To wszystko :)

Wydaje mi się, że @atomicules ma najprostszą odpowiedź, ale myślę, że można ją trochę uprościć. Musisz postawić @przed wszystkim, co chcesz być globalne, aby kompilowało się this.anythingi thisodnosiło do obiektu globalnego.

więc...

@bawbag = (x, y) ->
    z = (x * y)

bawbag(5, 10)

kompiluje się do ...

this.bawbag = function(x, y) {
  var z;
  return z = x * y;
};
bawbag(5, 10);

i działa wewnątrz i na zewnątrz opakowania podanego przez node.js

(function() {
    this.bawbag = function(x, y) {
      var z;
      return z = x * y;
    };
    console.log(bawbag(5,13)) // works here
}).call(this);

console.log(bawbag(5,11)) // works here

Ivo go przybił, ale wspomnę, że jest jedna brudna sztuczka, której można użyć, chociaż nie polecam jej, jeśli chcesz zdobyć punkty stylu: możesz osadzić kod JavaScript bezpośrednio w CoffeeScript, unikając go za pomocą backsticks.

Oto dlaczego jest to zwykle zły pomysł: kompilator CoffeeScript nie zna tych zmiennych, co oznacza, że ​​nie będą przestrzegać normalnych zasad określania zakresu CoffeeScript. Więc,

`foo = 'bar'`
foo = 'something else'

kompiluje się do

foo = 'bar';
var foo = 'something else';

a teraz masz dwie foos w różnych zakresach. Nie ma sposobu, aby zmodyfikować kod globalny foo z kodu CoffeeScript bez odwoływania się do obiektu globalnego, jak opisano w Ivy.

Oczywiście jest to problem tylko wtedy, gdy wykonasz zadanie foow CoffeeScript - jeśli stałoby się tylko do fooodczytu po otrzymaniu jego początkowej wartości (tj. Jest stałą globalną), wówczas podejście do osadzonego rozwiązania JavaScript może być trochę akceptowalne (choć nadal Niepolecane).

Możesz przekazać opcję -b podczas kompilowania kodu za pomocą skryptu do kawy w pliku node.js. Skompilowany kod będzie taki sam jak na coffeescript.org.

Aby dodać do odpowiedzi Ivo Wetzela

Wydaje się, że istnieje skrócona składnia exports ? this, którą mogę znaleźć tylko w dokumentach grupy Google .

Tj. Na stronie internetowej, aby udostępnić funkcję globalnie, deklarujesz ją ponownie z @prefiksem:

<script type="text/coffeescript">
    @aglobalfunction = aglobalfunction = () ->
         alert "Hello!"
</script>

<a href="javascript:aglobalfunction()" >Click me!</a>

Myślę, że to, co próbujesz osiągnąć, można po prostu zrobić w następujący sposób:

Podczas kompilowania skryptu coffeescript użyj parametru „-b”.

-b/ --bare Skompiluj JavaScript bez opakowania bezpieczeństwa funkcji najwyższego poziomu.

Więc coś takiego: coffee -b --compile somefile.coffee whatever.js

Spowoduje to wygenerowanie kodu tak jak w witrynie CoffeeScript.org.

Jeśli jesteś złym człowiekiem (ja jestem złym człowiekiem), możesz uzyskać tak proste: (->@)()

Jak w,

(->@)().im_a_terrible_programmer = yes
console.log im_a_terrible_programmer

To działa, ponieważ kiedy Wywoływanie ReferenceDo Function„gołe” (czyli func()zamiast new func()lub obj.func()), coś powszechnie określane jako „funkcja wywołania wywołania wzór”, zawsze wiąże thisdo globalnego obiektu dla tego kontekstu wykonania .

Powyższy CoffeeScript po prostu się kompiluje (function(){ return this })(); dlatego ćwiczymy to zachowanie, aby niezawodnie uzyskać dostęp do obiektu globalnego.

Ponieważ coffeescript jest rzadko używany samodzielnie, możesz użyć globalzmiennej dostarczonej przez node.js lub browserify (i dowolnych potomków, takich jak coffeeify, skrypty budowania gula itp.).

W node.js globalznajduje się globalna przestrzeń nazw.

W Browserify globaljest równy window.

Więc tylko:

somefunc = ->
  global.variable = 123