Вольный перевод статьи. Оригинал располагается здесь.

Первый релиз-кандидат Prototype 1.6.0 наконец созрел! core team продолжает традицию последовательного обновления API ядра в направлении увеличения производительности и исправлении ошибок. Продолжай читать, чтобы узнать какие произошли изменения в этом важном релизе, или скачай библиотеку сейчас чтобы познакомиться с ней безотлагательно.

Расширения Event API

Мы назвали 1.6.0 релизом "реконструкции событий" внутри команды, и это видно невооружённым глазом - одна их наших самых гавёных API стала одной их самых лучших. Вот, собственно, что было изменено:

• Обработчики событий, зарегистрированные с помощью Event.observe или Element#observe, теперь автоматически связываются с целевым элементом события во всех браузерах. Это значит, что по умолчанию обработчик ссылается на элемент, над которым произошло событие. Вы можете переопределить это поведение с помощью определения функции обработчика.
• Event-объект теперь расширяется коллекцией методов. Это значит вы можете теперь писать event.stop() вместо Event.stop(event). Более того, event-объект приводится в соответствие со стандартными именами свойств по WC3-стандарту, так например вы можете писать event.target вместо Event.element(event).
• Название события и аргументы обработчика в Event.stopObserving и Element#stopObserving теперь не обязательны, так например для полученных элементов вы можете быстро отменить все его обработчики или отменить все обработчики для одного элемента.
• Ссылки на элементы под наблюдением (на которые установлены какие-либо обработчики) больше не хранятся во внутреннем кеше во избежание утечек памяти.
• Prototype теперь поддерживает пользовательские события. Вызовите их на DOM элементе с помощью вызова Element#fire с указанием названия события и опционально memo объекта(прим. пер. - объект, который используется для передачи информации между посылателем события и получателем). Внутри Prototype трансформирует ваше пользовательское событие в реальное событие DOM, так что оно всплывет по документу подобно событию клика. Это значит, обработчики пользовательских событий могут реагировать на события из дочерних элементов. Вы можете обрабатывать и вызывать события на объекте document для глобальных событий.

  <div id="container">
  
    <h1><span id="title">Release notes</span></h1>
    ...
  </div>

  $("container").observe("titleChanged", function(event) {
    this.highlight({ duration: 0.5 });
  });
  
  $("title").fire("titleChanged");

• Мы встроили кросс-браузерную поддержку DOMContentLoaded события посредством нашей собственной событийной системы, так что вы можете быть уведомлены, как только документ полностью загружен:

  document.observe ("contentloaded", function(){ ... })

• Function#wrap привносит частицу аспектно-ориентированного программирования в отдельные методы, позволяет вам легче встраивать в существующие функции указанное поведение до и после, обработку возвращаемого значения, или вообще отмену обращения к оригинальной функции. Здесь пример использования wrap для добавления поведения в существующий метод прототипа String:

  String.prototype.capitalize = String.prototype.capitalize.wrap( 
    function(proceed, eachWord) { 
      if (eachWord && this.include(" ")) {
        // capitalize each word in the string
        return this.split(" ").invoke("capitalize").join(" ");
      } else {
        // proceed using the original function
        return proceed(); 
      }
    }); 
  
  "hello world".capitalize()     // "Hello world" 
  "hello world".capitalize(true) // "Hello World"

  Для более извращенного примера, смотрите как можно добавить jQuery-стиль методам коллекции элементов. ($$(“div.widget”).show().highlight()) всего за 40 строк кода обертки для $$ и Element.addMethods.
• Function#curry позволяет частичное применение функции (partial function application), подобно Function#bind, но сохранная контекст функции неизменённым.

  function sum(a, b) {
    return a + b;
  }
  
  sum(10, 5) // 15
  var addTen = sum.curry(10);
  addTen(5)  // 15

• Function#methodize инкапсулирует паттерн конвертирования первого аргумента функции в this-значение.

  function addBorder(element, color) {
    return $(element).setStyle({ 
      border: "3px solid " + (color || "red")
    });
  }
  
  addBorder("sidebar", "#ddd");
  $("sidebar").addBorder = addBorder.methodize();
  $("sidebar").addBorder("#888");

  Prototype интенсивно использует methodize внутри; для примера, многие Math методы добавлены к экземплярам Number:

  $w("abs round ceil floor").each(function(method) { 
    Number.prototype[method] = Math[method].methodize();
  }); 

• Function#argumentNames возвращает массив строк, представляющий именованные аргументы функции, извлеченные из результата выполнения toString() функций.
• Function#delay предостовляет удобную обёртку к window.setTimeout, и Function#defer - это delay с 10ms таймаутом.

  // добавить класс "busy" через одну секунду
  (function() { $("form").addClassName("busy") }).delay(1);
  //  вызвать событие "requestSent" асинхронно
  (function() { $("form").fire("requestSent") }).defer();

• Class.create теперь поддерживает 3 альтернативные формы вызова: теперь вы можете передать базовый класс для наследования, анонимный объект для примешивания (прим. пер. - механизм примесей) к прототипу нового класса, или одновременно и всё сразу.
• Новый метод Class.extend работает подобно Object.extend, примешивает исходный объект к прототипу результирующего класса.
• Если вы переопределили метод из базового класса, то вы можете теперь получить доступ к базовому методу, указав в перегруженной функции первым агрументом $super. Этот способ работает подобно Function#wrap (на самом деле и используется Function#wrap).

  var Animal = Class.create({
    initialize: function(name) {
      this.name = name;
    },
    eat: function() {
      return this.say("Yum!");
    },
    say: function(message) {
      return this.name + ": " + message;
    }
  });
  
  // subclass that augments a method
  var Cat = Class.create(Animal, {
    eat: function($super, food) {
      if (food instanceof Mouse) return $super();
      else return this.say("Yuk! I only eat mice.");
    }
  });

• Классы теперь имеют constructor, superclass, и subclasses свойства для реализации возможности проследить иерархию наследования.

• Теперь вы можете обращаться к телу JSON ответа как к JavaScript объекту, используя свойство responseJSON объекта-передатчика. (JSON ответы должны иметь заголовок Content-type со значением application/json.)

  new Ajax.Request("/people/5.json", {        // >> GET /people/5.json HTTP/1.1
    onSuccess: function(transport) {          // << Content-type: application/json
      var person = transport.responseJSON;    // << { id: 5, name: "Tobie Langel", 
      person.city  // "Geneva"                // <<   city: "Geneva", ... }
      ...
    }, method: "get" 
  });
  

• Передающий объект сейчас оборачивается Prototype-ом в экземпляр Ajax.Response, так что он может быть дополнен свойствами вроде responseJSON во всех браузерах. Ajax.Response к тому же имеет 2 новые возможности, безошибочные методы для доступа к заголовкам, getHeader и getAllHeaders; легкий доступ к передатчик и запрос объектам обеспечивается свойствами request и transport; и прямой доступ ко всем остальным методам и свойствам объекта-передатчика для полной совместимости.

• sanitizeJSON (true по умолчанию) проверяет строку на возможные вредоносные фрагменты и предотвращает их выполнение, если такие фрагменты обнаружены.
• evalJSON (true по умолчанию) автоматическое вычисление JSON информации, если заголовок Content-type ответа равен application/json и делает её доступной через свойство responseJSON объекта-ответа.
• evalJS (true по умолчанию) автоматическое выполнение JavaScript, если заголовок Content-type ответа равен text/javascript или чему-нибудь подобному.

• Prototype теперь обладает новым кросс-браузерным DOM Builder-ом :

new Element("input", { name: "user", disabled: true });
//-> <input name="user" disabled="disabled" />

• Insertion объект и пространство имен Position объявлены устаревшими в этом релизе. Вместо них теперь необходимо обращаться к методам Element. Element#insert принимает разные виды контента(DOM элементы, HTML код, простой текст, или любой объект):

$("items").insert({ after: new Element("p") });
$("items").insert({ top: "<li>an item</li>" });
$("items").insert("<li>another item</li>"); // defaults to bottom

var Calendar = Class.create({
  // ...,
  toElement: function() {
    var container = new Element("div");
    // ...
    return container;
  }
});

$("sidebar").insert(new Calendar());
// same as $("sidebar").insert({ bottom: new Calendar() }) or
//         $("sidebar").insert({ bottom: new Calendar().toElement() })

• Element#update и Element#replace теперь принимают DOM элементы или объекты с методами toHTML или toElement. Также сглажена ситуация с <table>- и <select>-относительные (related) элементами в IE и Opera 9.
• Element#setStyle теперь принимает или строку с CSS правилом (введено в этой версии), или хеш пар стиль/значение.

$("header").setStyle("font-size: 12px; float: left; opacity: 0.5");

$("header").setStyle({ "font-size": "12px" });

$("header").setStyle({ fontSize: "12px" });
$("header").setStyle("font-size: 12px");

document.viewport.getDimensions()     // { width: 1149, height: 923 }
document.viewport.getWidth()          // 1149
document.viewport.getHeight()         // 923
document.viewport.getScrollOffsets()  // { left: 0, top: 1592 }

elements.grep(new Selector("div.widget:first-child"))