// Copyright (c) 2009 The Chromium Authors. All rights reserved. // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. #include "chrome/common/extensions/extension_message_bundle.h" #include #include #include "base/i18n/rtl.h" #include "base/linked_ptr.h" #include "base/scoped_ptr.h" #include "base/string_util.h" #include "base/utf_string_conversions.h" #include "base/values.h" #include "chrome/common/extensions/extension_constants.h" #include "chrome/common/extensions/extension_error_utils.h" #include "chrome/common/extensions/extension_l10n_util.h" #include "testing/gtest/include/gtest/gtest.h" namespace errors = extension_manifest_errors; class ExtensionMessageBundleTest : public testing::Test { protected: enum BadDictionary { INVALID_NAME, NAME_NOT_A_TREE, EMPTY_NAME_TREE, MISSING_MESSAGE, PLACEHOLDER_NOT_A_TREE, EMPTY_PLACEHOLDER_TREE, CONTENT_MISSING, MESSAGE_PLACEHOLDER_DOESNT_MATCH, }; // Helper method for dictionary building. void SetDictionary(const std::string& name, DictionaryValue* subtree, DictionaryValue* target) { target->Set(name, static_cast(subtree)); } void CreateContentTree(const std::string& name, const std::string& content, DictionaryValue* dict) { DictionaryValue* content_tree = new DictionaryValue; content_tree->SetString(ExtensionMessageBundle::kContentKey, content); SetDictionary(name, content_tree, dict); } void CreatePlaceholdersTree(DictionaryValue* dict) { DictionaryValue* placeholders_tree = new DictionaryValue; CreateContentTree("a", "A", placeholders_tree); CreateContentTree("b", "B", placeholders_tree); CreateContentTree("c", "C", placeholders_tree); SetDictionary(ExtensionMessageBundle::kPlaceholdersKey, placeholders_tree, dict); } void CreateMessageTree(const std::string& name, const std::string& message, bool create_placeholder_subtree, DictionaryValue* dict) { DictionaryValue* message_tree = new DictionaryValue; if (create_placeholder_subtree) CreatePlaceholdersTree(message_tree); message_tree->SetString(ExtensionMessageBundle::kMessageKey, message); SetDictionary(name, message_tree, dict); } // Caller owns the memory. DictionaryValue* CreateGoodDictionary() { DictionaryValue* dict = new DictionaryValue; CreateMessageTree("n1", "message1 $a$ $b$", true, dict); CreateMessageTree("n2", "message2 $c$", true, dict); CreateMessageTree("n3", "message3", false, dict); return dict; } // Caller owns the memory. DictionaryValue* CreateBadDictionary(enum BadDictionary what_is_bad) { DictionaryValue* dict = CreateGoodDictionary(); // Now remove/break things. switch (what_is_bad) { case INVALID_NAME: CreateMessageTree("n 5", "nevermind", false, dict); break; case NAME_NOT_A_TREE: dict->SetString("n4", "whatever"); break; case EMPTY_NAME_TREE: { DictionaryValue* empty_tree = new DictionaryValue; SetDictionary("n4", empty_tree, dict); } break; case MISSING_MESSAGE: dict->Remove("n1.message", NULL); break; case PLACEHOLDER_NOT_A_TREE: dict->SetString("n1.placeholders", "whatever"); break; case EMPTY_PLACEHOLDER_TREE: { DictionaryValue* empty_tree = new DictionaryValue; SetDictionary("n1.placeholders", empty_tree, dict); } break; case CONTENT_MISSING: dict->Remove("n1.placeholders.a.content", NULL); break; case MESSAGE_PLACEHOLDER_DOESNT_MATCH: DictionaryValue* value; dict->Remove("n1.placeholders.a", NULL); dict->GetDictionary("n1.placeholders", &value); CreateContentTree("x", "X", value); break; } return dict; } unsigned int ReservedMessagesCount() { // Update when adding new reserved messages. return 5U; } void CheckReservedMessages(ExtensionMessageBundle* handler) { std::string ui_locale = extension_l10n_util::CurrentLocaleOrDefault(); EXPECT_EQ(ui_locale, handler->GetL10nMessage(ExtensionMessageBundle::kUILocaleKey)); std::string text_dir = "ltr"; if (base::i18n::GetTextDirectionForLocale(ui_locale.c_str()) == base::i18n::RIGHT_TO_LEFT) text_dir = "rtl"; EXPECT_EQ(text_dir, handler->GetL10nMessage( ExtensionMessageBundle::kBidiDirectionKey)); } bool AppendReservedMessages(const std::string& application_locale) { std::string error; return handler_->AppendReservedMessagesForLocale( application_locale, &error); } std::string CreateMessageBundle() { std::string error; handler_.reset(ExtensionMessageBundle::Create(catalogs_, &error)); return error; } void ClearDictionary() { handler_->dictionary_.clear(); } scoped_ptr handler_; std::vector > catalogs_; }; TEST_F(ExtensionMessageBundleTest, ReservedMessagesCount) { ASSERT_EQ(5U, ReservedMessagesCount()); } TEST_F(ExtensionMessageBundleTest, InitEmptyDictionaries) { CreateMessageBundle(); EXPECT_TRUE(handler_.get() != NULL); EXPECT_EQ(0U + ReservedMessagesCount(), handler_->size()); CheckReservedMessages(handler_.get()); } TEST_F(ExtensionMessageBundleTest, InitGoodDefaultDict) { catalogs_.push_back(linked_ptr(CreateGoodDictionary())); CreateMessageBundle(); EXPECT_TRUE(handler_.get() != NULL); EXPECT_EQ(3U + ReservedMessagesCount(), handler_->size()); EXPECT_EQ("message1 A B", handler_->GetL10nMessage("n1")); EXPECT_EQ("message2 C", handler_->GetL10nMessage("n2")); EXPECT_EQ("message3", handler_->GetL10nMessage("n3")); CheckReservedMessages(handler_.get()); } TEST_F(ExtensionMessageBundleTest, InitAppDictConsultedFirst) { catalogs_.push_back(linked_ptr(CreateGoodDictionary())); catalogs_.push_back(linked_ptr(CreateGoodDictionary())); DictionaryValue* app_dict = catalogs_[0].get(); // Flip placeholders in message of n1 tree. app_dict->SetString("n1.message", "message1 $b$ $a$"); // Remove one message from app dict. app_dict->Remove("n2", NULL); // Replace n3 with N3. app_dict->Remove("n3", NULL); CreateMessageTree("N3", "message3_app_dict", false, app_dict); CreateMessageBundle(); EXPECT_TRUE(handler_.get() != NULL); EXPECT_EQ(3U + ReservedMessagesCount(), handler_->size()); EXPECT_EQ("message1 B A", handler_->GetL10nMessage("n1")); EXPECT_EQ("message2 C", handler_->GetL10nMessage("n2")); EXPECT_EQ("message3_app_dict", handler_->GetL10nMessage("n3")); CheckReservedMessages(handler_.get()); } TEST_F(ExtensionMessageBundleTest, InitBadAppDict) { catalogs_.push_back( linked_ptr(CreateBadDictionary(INVALID_NAME))); catalogs_.push_back(linked_ptr(CreateGoodDictionary())); std::string error = CreateMessageBundle(); EXPECT_TRUE(handler_.get() == NULL); EXPECT_EQ("Name of a key \"n 5\" is invalid. Only ASCII [a-z], " "[A-Z], [0-9] and \"_\" are allowed.", error); catalogs_[0].reset(CreateBadDictionary(NAME_NOT_A_TREE)); handler_.reset(ExtensionMessageBundle::Create(catalogs_, &error)); EXPECT_TRUE(handler_.get() == NULL); EXPECT_EQ("Not a valid tree for key n4.", error); catalogs_[0].reset(CreateBadDictionary(EMPTY_NAME_TREE)); handler_.reset(ExtensionMessageBundle::Create(catalogs_, &error)); EXPECT_TRUE(handler_.get() == NULL); EXPECT_EQ("There is no \"message\" element for key n4.", error); catalogs_[0].reset(CreateBadDictionary(MISSING_MESSAGE)); handler_.reset(ExtensionMessageBundle::Create(catalogs_, &error)); EXPECT_TRUE(handler_.get() == NULL); EXPECT_EQ("There is no \"message\" element for key n1.", error); catalogs_[0].reset(CreateBadDictionary(PLACEHOLDER_NOT_A_TREE)); handler_.reset(ExtensionMessageBundle::Create(catalogs_, &error)); EXPECT_TRUE(handler_.get() == NULL); EXPECT_EQ("Not a valid \"placeholders\" element for key n1.", error); catalogs_[0].reset(CreateBadDictionary(EMPTY_PLACEHOLDER_TREE)); handler_.reset(ExtensionMessageBundle::Create(catalogs_, &error)); EXPECT_TRUE(handler_.get() == NULL); EXPECT_EQ("Variable $a$ used but not defined.", error); catalogs_[0].reset(CreateBadDictionary(CONTENT_MISSING)); handler_.reset(ExtensionMessageBundle::Create(catalogs_, &error)); EXPECT_TRUE(handler_.get() == NULL); EXPECT_EQ("Invalid \"content\" element for key n1.", error); catalogs_[0].reset(CreateBadDictionary(MESSAGE_PLACEHOLDER_DOESNT_MATCH)); handler_.reset(ExtensionMessageBundle::Create(catalogs_, &error)); EXPECT_TRUE(handler_.get() == NULL); EXPECT_EQ("Variable $a$ used but not defined.", error); } TEST_F(ExtensionMessageBundleTest, ReservedMessagesOverrideDeveloperMessages) { catalogs_.push_back(linked_ptr(CreateGoodDictionary())); DictionaryValue* dict = catalogs_[0].get(); CreateMessageTree(ExtensionMessageBundle::kUILocaleKey, "x", false, dict); std::string error = CreateMessageBundle(); EXPECT_TRUE(handler_.get() == NULL); std::string expected_error = ExtensionErrorUtils::FormatErrorMessage( errors::kReservedMessageFound, ExtensionMessageBundle::kUILocaleKey); EXPECT_EQ(expected_error, error); } TEST_F(ExtensionMessageBundleTest, AppendReservedMessagesForLTR) { CreateMessageBundle(); ASSERT_TRUE(handler_.get() != NULL); ClearDictionary(); ASSERT_TRUE(AppendReservedMessages("en_US")); EXPECT_EQ("en_US", handler_->GetL10nMessage(ExtensionMessageBundle::kUILocaleKey)); EXPECT_EQ("ltr", handler_->GetL10nMessage( ExtensionMessageBundle::kBidiDirectionKey)); EXPECT_EQ("rtl", handler_->GetL10nMessage( ExtensionMessageBundle::kBidiReversedDirectionKey)); EXPECT_EQ("left", handler_->GetL10nMessage( ExtensionMessageBundle::kBidiStartEdgeKey)); EXPECT_EQ("right", handler_->GetL10nMessage( ExtensionMessageBundle::kBidiEndEdgeKey)); } TEST_F(ExtensionMessageBundleTest, AppendReservedMessagesForRTL) { CreateMessageBundle(); ASSERT_TRUE(handler_.get() != NULL); ClearDictionary(); ASSERT_TRUE(AppendReservedMessages("he")); EXPECT_EQ("he", handler_->GetL10nMessage(ExtensionMessageBundle::kUILocaleKey)); EXPECT_EQ("rtl", handler_->GetL10nMessage( ExtensionMessageBundle::kBidiDirectionKey)); EXPECT_EQ("ltr", handler_->GetL10nMessage( ExtensionMessageBundle::kBidiReversedDirectionKey)); EXPECT_EQ("right", handler_->GetL10nMessage( ExtensionMessageBundle::kBidiStartEdgeKey)); EXPECT_EQ("left", handler_->GetL10nMessage( ExtensionMessageBundle::kBidiEndEdgeKey)); } TEST_F(ExtensionMessageBundleTest, IsValidNameCheckValidCharacters) { EXPECT_TRUE(ExtensionMessageBundle::IsValidName(std::string("a__BV_9"))); EXPECT_TRUE(ExtensionMessageBundle::IsValidName(std::string("@@a__BV_9"))); EXPECT_FALSE(ExtensionMessageBundle::IsValidName(std::string("$a__BV_9$"))); EXPECT_FALSE(ExtensionMessageBundle::IsValidName(std::string("a-BV-9"))); EXPECT_FALSE(ExtensionMessageBundle::IsValidName(std::string("a#BV!9"))); EXPECT_FALSE(ExtensionMessageBundle::IsValidName(std::string("asize()); EXPECT_EQ("message_value", (*map)["message_name"]); }