alerts.rb in watir-webdriver-0.6.0

- old
+ new

@@ -1,8 +1,10 @@
 module Watir
 
   #
+  # Deprecated, use the new Alert API instead.
+  #
   # Module provided by optional require:
   #
   #   require "watir-webdriver/extensions/alerts"
   #
 
@@ -18,10 +20,11 @@
     #     browser.button(:value => "Alert").click
     #   end #=> "the alert message"
     #
 
     def alert(&blk)
+      warn 'AlertHelper is deprecated. Use the new Alert API instead (e.g. browser.alert.close)'
       execute_script "window.alert = function(msg) { window.__lastWatirAlert = msg; }"
       yield
       execute_script "return window.__lastWatirAlert"
     end
 
@@ -34,10 +37,11 @@
     #   browser.confirm(true) do
     #     browser.button(:value => "Confirm").click
     #   end #=> "the confirm message"
 
     def confirm(bool, &blk)
+      warn 'AlertHelper is deprecated. Use the new Alert API instead (e.g. browser.confirm.close)'
       execute_script "window.confirm = function(msg) { window.__lastWatirConfirm = msg; return #{!!bool} }"
       yield
       execute_script "return window.__lastWatirConfirm"
     end
 
@@ -51,9 +55,10 @@
     #     browser.button(:value => "Prompt").click
     #   end #=> { :message => "foo", :default_value => "bar" }
     #
 
     def prompt(answer, &blk)
+      warn 'AlertHelper is deprecated. Use the new Alert API instead (e.g. browser.prompt.close)'
       execute_script "window.prompt = function(text, value) { window.__lastWatirPrompt = { message: text, default_value: value }; return #{MultiJson.encode answer}; }"
       yield
       result = execute_script "return window.__lastWatirPrompt"
 
       result && result.dup.each_key { |k| result[k.to_sym] = result.delete(k)}