// Copyright 2014 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 "extensions/common/message_bundle.h" #include #include #include #include #include #include "base/i18n/rtl.h" #include "base/macros.h" #include "base/strings/string_util.h" #include "base/strings/utf_string_conversions.h" #include "base/values.h" #include "extensions/common/error_utils.h" #include "extensions/common/extension_l10n_util.h" #include "extensions/common/manifest_constants.h" #include "testing/gtest/include/gtest/gtest.h" namespace extensions { namespace errors = manifest_errors; class MessageBundleTest : 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, }; void CreateContentTree(const std::string& name, const std::string& content, base::DictionaryValue* dict) { auto content_tree = std::make_unique(); content_tree->SetString(MessageBundle::kContentKey, content); dict->Set(name, std::move(content_tree)); } void CreatePlaceholdersTree(base::DictionaryValue* dict) { auto placeholders_tree = std::make_unique(); CreateContentTree("a", "A", placeholders_tree.get()); CreateContentTree("b", "B", placeholders_tree.get()); CreateContentTree("c", "C", placeholders_tree.get()); dict->Set(MessageBundle::kPlaceholdersKey, std::move(placeholders_tree)); } void CreateMessageTree(const std::string& name, const std::string& message, bool create_placeholder_subtree, base::DictionaryValue* dict) { auto message_tree = std::make_unique(); if (create_placeholder_subtree) CreatePlaceholdersTree(message_tree.get()); message_tree->SetString(MessageBundle::kMessageKey, message); dict->Set(name, std::move(message_tree)); } std::unique_ptr CreateGoodDictionary() { auto dict = std::make_unique(); CreateMessageTree("n1", "message1 $a$ $b$", true, dict.get()); CreateMessageTree("n2", "message2 $c$", true, dict.get()); CreateMessageTree("n3", "message3", false, dict.get()); return dict; } std::unique_ptr CreateBadDictionary( enum BadDictionary what_is_bad) { std::unique_ptr dict = CreateGoodDictionary(); // Now remove/break things. switch (what_is_bad) { case INVALID_NAME: CreateMessageTree("n 5", "nevermind", false, dict.get()); break; case NAME_NOT_A_TREE: dict->SetString("n4", "whatever"); break; case EMPTY_NAME_TREE: dict->Set("n4", std::make_unique()); 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: dict->Set("n1.placeholders", std::make_unique()); break; case CONTENT_MISSING: dict->Remove("n1.placeholders.a.content", NULL); break; case MESSAGE_PLACEHOLDER_DOESNT_MATCH: base::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(MessageBundle* handler) { std::string ui_locale = extension_l10n_util::CurrentLocaleOrDefault(); EXPECT_EQ(ui_locale, handler->GetL10nMessage(MessageBundle::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( MessageBundle::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(MessageBundle::Create(catalogs_, &error)); return error; } void ClearDictionary() { handler_->dictionary_.clear(); } std::unique_ptr handler_; std::vector> catalogs_; }; TEST_F(MessageBundleTest, ReservedMessagesCount) { ASSERT_EQ(5U, ReservedMessagesCount()); } TEST_F(MessageBundleTest, InitEmptyDictionaries) { CreateMessageBundle(); EXPECT_TRUE(handler_.get() != NULL); EXPECT_EQ(0U + ReservedMessagesCount(), handler_->size()); CheckReservedMessages(handler_.get()); } TEST_F(MessageBundleTest, InitGoodDefaultDict) { catalogs_.push_back(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(MessageBundleTest, InitAppDictConsultedFirst) { catalogs_.push_back(CreateGoodDictionary()); catalogs_.push_back(CreateGoodDictionary()); base::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(MessageBundleTest, InitBadAppDict) { catalogs_.push_back(CreateBadDictionary(INVALID_NAME)); catalogs_.push_back(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] = CreateBadDictionary(NAME_NOT_A_TREE); handler_.reset(MessageBundle::Create(catalogs_, &error)); EXPECT_TRUE(handler_.get() == NULL); EXPECT_EQ("Not a valid tree for key n4.", error); catalogs_[0] = CreateBadDictionary(EMPTY_NAME_TREE); handler_.reset(MessageBundle::Create(catalogs_, &error)); EXPECT_TRUE(handler_.get() == NULL); EXPECT_EQ("There is no \"message\" element for key n4.", error); catalogs_[0] = CreateBadDictionary(MISSING_MESSAGE); handler_.reset(MessageBundle::Create(catalogs_, &error)); EXPECT_TRUE(handler_.get() == NULL); EXPECT_EQ("There is no \"message\" element for key n1.", error); catalogs_[0] = CreateBadDictionary(PLACEHOLDER_NOT_A_TREE); handler_.reset(MessageBundle::Create(catalogs_, &error)); EXPECT_TRUE(handler_.get() == NULL); EXPECT_EQ("Not a valid \"placeholders\" element for key n1.", error); catalogs_[0] = CreateBadDictionary(EMPTY_PLACEHOLDER_TREE); handler_.reset(MessageBundle::Create(catalogs_, &error)); EXPECT_TRUE(handler_.get() == NULL); EXPECT_EQ("Variable $a$ used but not defined.", error); catalogs_[0] = CreateBadDictionary(CONTENT_MISSING); handler_.reset(MessageBundle::Create(catalogs_, &error)); EXPECT_TRUE(handler_.get() == NULL); EXPECT_EQ("Invalid \"content\" element for key n1.", error); catalogs_[0] = CreateBadDictionary(MESSAGE_PLACEHOLDER_DOESNT_MATCH); handler_.reset(MessageBundle::Create(catalogs_, &error)); EXPECT_TRUE(handler_.get() == NULL); EXPECT_EQ("Variable $a$ used but not defined.", error); } TEST_F(MessageBundleTest, ReservedMessagesOverrideDeveloperMessages) { catalogs_.push_back(CreateGoodDictionary()); base::DictionaryValue* dict = catalogs_[0].get(); CreateMessageTree(MessageBundle::kUILocaleKey, "x", false, dict); std::string error = CreateMessageBundle(); EXPECT_TRUE(handler_.get() == NULL); std::string expected_error = ErrorUtils::FormatErrorMessage( errors::kReservedMessageFound, MessageBundle::kUILocaleKey); EXPECT_EQ(expected_error, error); } TEST_F(MessageBundleTest, AppendReservedMessagesForLTR) { CreateMessageBundle(); ASSERT_TRUE(handler_.get() != NULL); ClearDictionary(); ASSERT_TRUE(AppendReservedMessages("en_US")); EXPECT_EQ("en_US", handler_->GetL10nMessage(MessageBundle::kUILocaleKey)); EXPECT_EQ("ltr", handler_->GetL10nMessage( MessageBundle::kBidiDirectionKey)); EXPECT_EQ("rtl", handler_->GetL10nMessage( MessageBundle::kBidiReversedDirectionKey)); EXPECT_EQ("left", handler_->GetL10nMessage( MessageBundle::kBidiStartEdgeKey)); EXPECT_EQ("right", handler_->GetL10nMessage( MessageBundle::kBidiEndEdgeKey)); } TEST_F(MessageBundleTest, AppendReservedMessagesForRTL) { CreateMessageBundle(); ASSERT_TRUE(handler_.get() != NULL); ClearDictionary(); ASSERT_TRUE(AppendReservedMessages("he")); EXPECT_EQ("he", handler_->GetL10nMessage(MessageBundle::kUILocaleKey)); EXPECT_EQ("rtl", handler_->GetL10nMessage( MessageBundle::kBidiDirectionKey)); EXPECT_EQ("ltr", handler_->GetL10nMessage( MessageBundle::kBidiReversedDirectionKey)); EXPECT_EQ("right", handler_->GetL10nMessage( MessageBundle::kBidiStartEdgeKey)); EXPECT_EQ("left", handler_->GetL10nMessage( MessageBundle::kBidiEndEdgeKey)); } TEST_F(MessageBundleTest, IsValidNameCheckValidCharacters) { EXPECT_TRUE(MessageBundle::IsValidName(std::string("a__BV_9"))); EXPECT_TRUE(MessageBundle::IsValidName(std::string("@@a__BV_9"))); EXPECT_FALSE(MessageBundle::IsValidName(std::string("$a__BV_9$"))); EXPECT_FALSE(MessageBundle::IsValidName(std::string("a-BV-9"))); EXPECT_FALSE(MessageBundle::IsValidName(std::string("a#BV!9"))); EXPECT_FALSE(MessageBundle::IsValidName(std::string("asize()); EXPECT_EQ("message_value", (*map)["message_name"]); } } // namespace extensions