ppapi/tests/test_var_deprecated.cc

   1 // Copyright (c) 2011 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 #include "ppapi/tests/test_var_deprecated.h"
   6
   7 #include <string.h>
   8
   9 #include <limits>
  10
  11 #include "base/basictypes.h"
  12 #include "ppapi/c/pp_var.h"
  13 #include "ppapi/c/dev/ppb_testing_dev.h"
  14 #include "ppapi/c/dev/ppb_var_deprecated.h"
  15 #include "ppapi/cpp/dev/scriptable_object_deprecated.h"
  16 #include "ppapi/cpp/instance.h"
  17 #include "ppapi/cpp/module.h"
  18 #include "ppapi/cpp/private/var_private.h"
  19 #include "ppapi/cpp/var.h"
  20 #include "ppapi/tests/testing_instance.h"
  21
  22 namespace {
  23
  24 uint32_t kInvalidLength = static_cast<uint32_t>(-1);
  25
  26 static const char kSetValueFunction[] = "SetValue";
  27
  28 // ScriptableObject used by the var tests.
  29 class VarScriptableObject : public pp::deprecated::ScriptableObject {
  30  public:
  31   VarScriptableObject(TestVarDeprecated* v) : test_var_deprecated_(v) {}
  32
  33   // pp::deprecated::ScriptableObject overrides.
  34   bool HasMethod(const pp::Var& name, pp::Var* exception);
  35   pp::Var Call(const pp::Var& name,
  36                const std::vector<pp::Var>& args,
  37                pp::Var* exception);
  38
  39  private:
  40   TestVarDeprecated* test_var_deprecated_;
  41 };
  42
  43 bool VarScriptableObject::HasMethod(const pp::Var& name, pp::Var* exception) {
  44   if (!name.is_string())
  45     return false;
  46   return name.AsString() == kSetValueFunction;
  47 }
  48
  49 pp::Var VarScriptableObject::Call(const pp::Var& method_name,
  50                                   const std::vector<pp::Var>& args,
  51                                   pp::Var* exception) {
  52   if (!method_name.is_string())
  53     return false;
  54   std::string name = method_name.AsString();
  55
  56   if (name == kSetValueFunction) {
  57     if (args.size() != 1)
  58       *exception = pp::Var("Bad argument to SetValue(<value>)");
  59     else
  60       test_var_deprecated_->set_var_from_page(pp::VarPrivate(args[0]));
  61   }
  62
  63   return pp::Var();
  64 }
  65
  66 }  // namespace
  67
  68 REGISTER_TEST_CASE(VarDeprecated);
  69
  70 bool TestVarDeprecated::Init() {
  71   var_interface_ = static_cast<const PPB_Var_Deprecated*>(
  72       pp::Module::Get()->GetBrowserInterface(PPB_VAR_DEPRECATED_INTERFACE));
  73   return var_interface_ && InitTestingInterface();
  74 }
  75
  76 void TestVarDeprecated::RunTest() {
  77   RUN_TEST(BasicString);
  78   RUN_TEST(InvalidAndEmpty);
  79   RUN_TEST(InvalidUtf8);
  80   RUN_TEST(NullInputInUtf8Conversion);
  81   RUN_TEST(ValidUtf8);
  82   RUN_TEST(Utf8WithEmbeddedNulls);
  83   RUN_TEST(VarToUtf8ForWrongType);
  84   RUN_TEST(HasPropertyAndMethod);
  85   RUN_TEST(PassReference);
  86 }
  87
  88 pp::deprecated::ScriptableObject* TestVarDeprecated::CreateTestObject() {
  89   return new VarScriptableObject(this);
  90 }
  91
  92 std::string TestVarDeprecated::TestBasicString() {
  93   uint32_t before_object = testing_interface_->GetLiveObjectsForInstance(
  94       instance_->pp_instance());
  95   {
  96     const char kStr[] = "Hello";
  97     const uint32_t kStrLen(arraysize(kStr) - 1);
  98     PP_Var str = var_interface_->VarFromUtf8(pp::Module::Get()->pp_module(),
  99                                              kStr, kStrLen);
 100     ASSERT_EQ(PP_VARTYPE_STRING, str.type);
 101
 102     // Reading back the string should work.
 103     uint32_t len = 0;
 104     const char* result = var_interface_->VarToUtf8(str, &len);
 105     ASSERT_EQ(kStrLen, len);
 106     ASSERT_EQ(0, strncmp(kStr, result, kStrLen));
 107
 108     // Destroy the string, readback should now fail.
 109     var_interface_->Release(str);
 110     result = var_interface_->VarToUtf8(str, &len);
 111     ASSERT_EQ(0, len);
 112     ASSERT_EQ(NULL, result);
 113   }
 114
 115   // Make sure nothing leaked.
 116   ASSERT_TRUE(testing_interface_->GetLiveObjectsForInstance(
 117       instance_->pp_instance()) == before_object);
 118
 119   PASS();
 120 }
 121
 122 std::string TestVarDeprecated::TestInvalidAndEmpty() {
 123   PP_Var invalid_string;
 124   invalid_string.type = PP_VARTYPE_STRING;
 125   invalid_string.value.as_id = 31415926;
 126
 127   // Invalid strings should give NULL as the return value.
 128   uint32_t len = std::numeric_limits<uint32_t>::max();
 129   const char* result = var_interface_->VarToUtf8(invalid_string, &len);
 130   ASSERT_EQ(0, len);
 131   ASSERT_EQ(NULL, result);
 132
 133   // Same with vars that are not strings.
 134   len = std::numeric_limits<uint32_t>::max();
 135   pp::Var int_var(42);
 136   result = var_interface_->VarToUtf8(int_var.pp_var(), &len);
 137   ASSERT_EQ(0, len);
 138   ASSERT_EQ(NULL, result);
 139
 140   // Empty strings should return non-NULL.
 141   pp::Var empty_string("");
 142   len = std::numeric_limits<uint32_t>::max();
 143   result = var_interface_->VarToUtf8(empty_string.pp_var(), &len);
 144   ASSERT_EQ(0, len);
 145   ASSERT_NE(NULL, result);
 146
 147   PASS();
 148 }
 149
 150 std::string TestVarDeprecated::TestInvalidUtf8() {
 151   // utf8じゃない (japanese for "is not utf8") in shift-jis encoding.
 152   static const char kSjisString[] = "utf8\x82\xb6\x82\xe1\x82\xc8\x82\xa2";
 153   pp::Var sjis(kSjisString);
 154   if (!sjis.is_null())
 155     return "Non-UTF8 string was permitted erroneously.";
 156
 157   PASS();
 158 }
 159
 160 std::string TestVarDeprecated::TestNullInputInUtf8Conversion() {
 161   // This test talks directly to the C interface to access edge cases that
 162   // cannot be exercised via the C++ interface.
 163   PP_Var converted_string;
 164
 165   // 0-length string should not dereference input string, and should produce
 166   // an empty string.
 167   converted_string = var_interface_->VarFromUtf8(
 168       pp::Module::Get()->pp_module(), NULL, 0);
 169   if (converted_string.type != PP_VARTYPE_STRING) {
 170     return "Expected 0 length to return empty string.";
 171   }
 172
 173   // Now convert it back.
 174   uint32_t length = kInvalidLength;
 175   const char* result = NULL;
 176   result = var_interface_->VarToUtf8(converted_string, &length);
 177   if (length != 0) {
 178     return "Expected 0 length string on conversion.";
 179   }
 180   if (result == NULL) {
 181     return "Expected a non-null result for 0-lengthed string from VarToUtf8.";
 182   }
 183
 184   // Should not crash, and make an empty string.
 185   const char* null_string = NULL;
 186   pp::Var null_var(null_string);
 187   if (!null_var.is_string() || null_var.AsString() != "") {
 188     return "Expected NULL input to make an empty string Var.";
 189   }
 190
 191   PASS();
 192 }
 193
 194 std::string TestVarDeprecated::TestValidUtf8() {
 195   // From UTF8 string -> PP_Var.
 196   // Chinese for "I am utf8."
 197   static const char kValidUtf8[] = "\xe6\x88\x91\xe6\x98\xafutf8.";
 198   pp::Var converted_string(kValidUtf8);
 199
 200   if (converted_string.is_null())
 201     return "Unable to convert valid utf8 to var.";
 202
 203   // Since we're already here, test PP_Var back to UTF8 string.
 204   std::string returned_string = converted_string.AsString();
 205
 206   // We need to check against 1 less than sizeof because the resulting string
 207   // is technically not NULL terminated by API design.
 208   if (returned_string.size() != sizeof(kValidUtf8) - 1) {
 209     return "Unable to convert utf8 string back from var.";
 210   }
 211   if (returned_string != kValidUtf8) {
 212     return "String mismatches on conversion back from PP_Var.";
 213   }
 214
 215   PASS();
 216 }
 217
 218 std::string TestVarDeprecated::TestUtf8WithEmbeddedNulls() {
 219   // From UTF8 string with embedded nulls -> PP_Var.
 220   // Chinese for "also utf8."
 221   static const char kUtf8WithEmbededNull[] = "\xe6\xb9\x9f\xe6\x98\xaf\0utf8.";
 222   std::string orig_string(kUtf8WithEmbededNull,
 223                           sizeof(kUtf8WithEmbededNull) -1);
 224   pp::Var converted_string(orig_string);
 225
 226   if (converted_string.is_null())
 227     return "Unable to convert utf8 with embedded nulls to var.";
 228
 229   // Since we're already here, test PP_Var back to UTF8 string.
 230   std::string returned_string = converted_string.AsString();
 231
 232   if (returned_string.size() != orig_string.size()) {
 233     return "Unable to convert utf8 with embedded nulls back from var.";
 234   }
 235   if (returned_string != orig_string) {
 236     return "String mismatches on conversion back from PP_Var.";
 237   }
 238
 239   PASS();
 240 }
 241
 242 std::string TestVarDeprecated::TestVarToUtf8ForWrongType() {
 243   uint32_t length = kInvalidLength;
 244   const char* result = NULL;
 245   result = var_interface_->VarToUtf8(PP_MakeUndefined(), &length);
 246   if (length != 0) {
 247     return "Expected 0 on string conversion from Void var.";
 248   }
 249   if (result != NULL) {
 250     return "Expected NULL on string conversion from Void var.";
 251   }
 252
 253   length = kInvalidLength;
 254   result = NULL;
 255   result = var_interface_->VarToUtf8(PP_MakeNull(), &length);
 256   if (length != 0) {
 257     return "Expected 0 on string conversion from Null var.";
 258   }
 259   if (result != NULL) {
 260     return "Expected NULL on string conversion from Null var.";
 261   }
 262
 263   length = kInvalidLength;
 264   result = NULL;
 265   result = var_interface_->VarToUtf8(PP_MakeBool(PP_TRUE), &length);
 266   if (length != 0) {
 267     return "Expected 0 on string conversion from Bool var.";
 268   }
 269   if (result != NULL) {
 270     return "Expected NULL on string conversion from Bool var.";
 271   }
 272
 273   length = kInvalidLength;
 274   result = NULL;
 275   result = var_interface_->VarToUtf8(PP_MakeInt32(1), &length);
 276   if (length != 0) {
 277     return "Expected 0 on string conversion from Int32 var.";
 278   }
 279   if (result != NULL) {
 280     return "Expected NULL on string conversion from Int32 var.";
 281   }
 282
 283   length = kInvalidLength;
 284   result = NULL;
 285   result = var_interface_->VarToUtf8(PP_MakeDouble(1.0), &length);
 286   if (length != 0) {
 287     return "Expected 0 on string conversion from Double var.";
 288   }
 289   if (result != NULL) {
 290     return "Expected NULL on string conversion from Double var.";
 291   }
 292
 293   PASS();
 294 }
 295
 296 std::string TestVarDeprecated::TestHasPropertyAndMethod() {
 297   pp::VarPrivate window = instance_->GetWindowObject();
 298   ASSERT_TRUE(window.is_object());
 299
 300   // Regular property.
 301   pp::Var exception;
 302   ASSERT_TRUE(window.HasProperty("scrollX", &exception));
 303   ASSERT_TRUE(exception.is_undefined());
 304   ASSERT_FALSE(window.HasMethod("scrollX", &exception));
 305   ASSERT_TRUE(exception.is_undefined());
 306
 307   // Regular method (also counts as HasProperty).
 308   ASSERT_TRUE(window.HasProperty("find", &exception));
 309   ASSERT_TRUE(exception.is_undefined());
 310   ASSERT_TRUE(window.HasMethod("find", &exception));
 311   ASSERT_TRUE(exception.is_undefined());
 312
 313   // Nonexistant ones should return false and not set the exception.
 314   ASSERT_FALSE(window.HasProperty("superEvilBit", &exception));
 315   ASSERT_TRUE(exception.is_undefined());
 316   ASSERT_FALSE(window.HasMethod("superEvilBit", &exception));
 317   ASSERT_TRUE(exception.is_undefined());
 318
 319   // Check exception and return false on invalid property name.
 320   ASSERT_FALSE(window.HasProperty(3.14159, &exception));
 321   ASSERT_FALSE(exception.is_undefined());
 322   exception = pp::Var();
 323
 324   exception = pp::Var();
 325   ASSERT_FALSE(window.HasMethod(3.14159, &exception));
 326   ASSERT_FALSE(exception.is_undefined());
 327
 328   // Try to use something not an object.
 329   exception = pp::Var();
 330   pp::VarPrivate string_object("asdf");
 331   ASSERT_FALSE(string_object.HasProperty("find", &exception));
 332   ASSERT_FALSE(exception.is_undefined());
 333   exception = pp::Var();
 334   ASSERT_FALSE(string_object.HasMethod("find", &exception));
 335   ASSERT_FALSE(exception.is_undefined());
 336
 337   // Try to use an invalid object (need to use the C API).
 338   PP_Var invalid_object;
 339   invalid_object.type = PP_VARTYPE_OBJECT;
 340   invalid_object.value.as_id = static_cast<int64_t>(-1234567);
 341   PP_Var exception2 = PP_MakeUndefined();
 342   ASSERT_FALSE(var_interface_->HasProperty(invalid_object,
 343                                            pp::Var("find").pp_var(),
 344                                            &exception2));
 345   ASSERT_NE(PP_VARTYPE_UNDEFINED, exception2.type);
 346   var_interface_->Release(exception2);
 347
 348   exception2 = PP_MakeUndefined();
 349   ASSERT_FALSE(var_interface_->HasMethod(invalid_object,
 350                                          pp::Var("find").pp_var(),
 351                                          &exception2));
 352   ASSERT_NE(PP_VARTYPE_UNDEFINED, exception2.type);
 353   var_interface_->Release(exception2);
 354
 355   // Getting a valid property/method when the exception is set returns false.
 356   exception = pp::Var("Bad something-or-other exception");
 357   ASSERT_FALSE(window.HasProperty("find", &exception));
 358   ASSERT_FALSE(exception.is_undefined());
 359   ASSERT_FALSE(window.HasMethod("find", &exception));
 360   ASSERT_FALSE(exception.is_undefined());
 361
 362   PASS();
 363 }
 364
 365 // Tests that when the page sends an object to the plugin via a function call,
 366 // that the refcounting works properly (bug 79813).
 367 std::string TestVarDeprecated::TestPassReference() {
 368   var_from_page_ = pp::Var();
 369
 370   // Send a JS object from the page to the plugin.
 371   pp::Var exception;
 372   pp::Var ret = instance_->ExecuteScript(
 373       "document.getElementById('plugin').SetValue(function(arg) {"
 374           "return 'works' + arg;"
 375       "})",
 376       &exception);
 377   ASSERT_TRUE(exception.is_undefined());
 378
 379   // We should have gotten an object set for our var_from_page.
 380   ASSERT_TRUE(var_from_page_.is_object());
 381
 382   // If the reference counting works, the object should be valid. We can test
 383   // this by executing it (it was a function we defined above) and it should
 384   // return "works" concatenated with the argument.
 385   pp::VarPrivate function(var_from_page_);
 386   pp::Var result = var_from_page_.Call(pp::Var(), "nice");
 387   ASSERT_TRUE(result.is_string());
 388   ASSERT_TRUE(result.AsString() == "worksnice");
 389
 390   PASS();
 391 }
 392