class NodeSaveTest in Drupal 10

Tests $node->save() for saving content.

@group node

Hierarchy

• class \Drupal\Tests\BrowserTestBase extends \PHPUnit\Framework\TestCase uses \Drupal\Tests\PhpUnitCompatibilityTrait, \Symfony\Bridge\PhpUnit\ExpectDeprecationTrait, FunctionalTestSetupTrait, TestSetupTrait, BlockCreationTrait, ConfigTestTrait, ExtensionListTestTrait, ContentTypeCreationTrait, NodeCreationTrait, RandomGeneratorTrait, TestRequirementsTrait, PhpUnitWarnings, UiHelperTrait, UserCreationTrait, XdebugRequestTrait
  • class \Drupal\Tests\node\Functional\NodeTestBase
    • class \Drupal\Tests\node\Functional\NodeSaveTest

File

core/modules/node/tests/src/Functional/NodeSaveTest.php, line 12

Namespace

Drupal\Tests\node\Functional

class NodeSaveTest extends NodeTestBase {

  /**
   * A normal logged in user.
   *
   * @var \Drupal\user\UserInterface
   */
  protected $webUser;

  /**
   * Modules to enable.
   *
   * @var array
   */
  protected static $modules = [
    'node_test',
  ];

  /**
   * {@inheritdoc}
   */
  protected $defaultTheme = 'stark';
  protected function setUp() : void {
    parent::setUp();

    // Create a user that is allowed to post; we'll use this to test the submission.
    $web_user = $this
      ->drupalCreateUser([
      'create article content',
    ]);
    $this
      ->drupalLogin($web_user);
    $this->webUser = $web_user;
  }

  /**
   * Checks whether custom node IDs are saved properly during an import operation.
   *
   * Workflow:
   *  - first create a piece of content
   *  - save the content
   *  - check if node exists
   */
  public function testImport() {

    // Node ID must be a number that is not in the database.
    $nids = \Drupal::entityTypeManager()
      ->getStorage('node')
      ->getQuery()
      ->accessCheck(FALSE)
      ->sort('nid', 'DESC')
      ->range(0, 1)
      ->execute();
    $max_nid = reset($nids);
    $test_nid = $max_nid + mt_rand(1000, 1000000);
    $title = $this
      ->randomMachineName(8);
    $node = [
      'title' => $title,
      'body' => [
        [
          'value' => $this
            ->randomMachineName(32),
        ],
      ],
      'uid' => $this->webUser
        ->id(),
      'type' => 'article',
      'nid' => $test_nid,
    ];

    /** @var \Drupal\node\NodeInterface $node */
    $node = Node::create($node);
    $node
      ->enforceIsNew();
    $this
      ->assertEquals($this->webUser
      ->id(), $node
      ->getOwnerId());
    $node
      ->save();

    // Test the import.
    $node_by_nid = Node::load($test_nid);
    $this
      ->assertNotEmpty($node_by_nid, 'Node load by node ID.');
    $node_by_title = $this
      ->drupalGetNodeByTitle($title);
    $this
      ->assertNotEmpty($node_by_title, 'Node load by node title.');
  }

  /**
   * Verifies accuracy of the "created" and "changed" timestamp functionality.
   */
  public function testTimestamps() {

    // Use the default timestamps.
    $edit = [
      'uid' => $this->webUser
        ->id(),
      'type' => 'article',
      'title' => $this
        ->randomMachineName(8),
    ];
    Node::create($edit)
      ->save();
    $node = $this
      ->drupalGetNodeByTitle($edit['title']);
    $this
      ->assertEquals(REQUEST_TIME, $node
      ->getCreatedTime(), 'Creating a node sets default "created" timestamp.');
    $this
      ->assertEquals(REQUEST_TIME, $node
      ->getChangedTime(), 'Creating a node sets default "changed" timestamp.');

    // Store the timestamps.
    $created = $node
      ->getCreatedTime();
    $node
      ->save();
    $node = $this
      ->drupalGetNodeByTitle($edit['title'], TRUE);
    $this
      ->assertEquals($created, $node
      ->getCreatedTime(), 'Updating a node preserves "created" timestamp.');

    // Programmatically set the timestamps using hook_ENTITY_TYPE_presave().
    $node->title = 'testing_node_presave';
    $node
      ->save();
    $node = $this
      ->drupalGetNodeByTitle('testing_node_presave', TRUE);
    $this
      ->assertEquals(280299600, $node
      ->getCreatedTime(), 'Saving a node uses "created" timestamp set in presave hook.');
    $this
      ->assertEquals(979534800, $node
      ->getChangedTime(), 'Saving a node uses "changed" timestamp set in presave hook.');

    // Programmatically set the timestamps on the node.
    $edit = [
      'uid' => $this->webUser
        ->id(),
      'type' => 'article',
      'title' => $this
        ->randomMachineName(8),
      // Sun, 19 Nov 1978 05:00:00 GMT.
      'created' => 280299600,
      // Drupal 1.0 release.
      'changed' => 979534800,
    ];
    Node::create($edit)
      ->save();
    $node = $this
      ->drupalGetNodeByTitle($edit['title']);
    $this
      ->assertEquals(280299600, $node
      ->getCreatedTime(), 'Creating a node programmatically uses programmatically set "created" timestamp.');
    $this
      ->assertEquals(979534800, $node
      ->getChangedTime(), 'Creating a node programmatically uses programmatically set "changed" timestamp.');

    // Update the timestamps.
    $node
      ->setCreatedTime(979534800);
    $node->changed = 280299600;
    $node
      ->save();
    $node = $this
      ->drupalGetNodeByTitle($edit['title'], TRUE);
    $this
      ->assertEquals(979534800, $node
      ->getCreatedTime(), 'Updating a node uses user-set "created" timestamp.');

    // Allowing setting changed timestamps is required, see
    // Drupal\content_translation\ContentTranslationMetadataWrapper::setChangedTime($timestamp)
    // for example.
    $this
      ->assertEquals(280299600, $node
      ->getChangedTime(), 'Updating a node uses user-set "changed" timestamp.');
  }

  /**
   * Tests node presave and static node load cache.
   *
   * This test determines changes in hook_ENTITY_TYPE_presave() and verifies
   * that the static node load cache is cleared upon save.
   */
  public function testDeterminingChanges() {

    // Initial creation.
    $node = Node::create([
      'uid' => $this->webUser
        ->id(),
      'type' => 'article',
      'title' => 'test_changes',
    ]);
    $node
      ->save();

    // Update the node without applying changes.
    $node
      ->save();
    $this
      ->assertEquals('test_changes', $node
      ->label(), 'No changes have been determined.');

    // Apply changes.
    $node->title = 'updated';
    $node
      ->save();

    // The hook implementations node_test_node_presave() and
    // node_test_node_update() determine changes and change the title.
    $this
      ->assertEquals('updated_presave_update', $node
      ->label(), 'Changes have been determined.');

    // Test the static node load cache to be cleared.
    $node = Node::load($node
      ->id());
    $this
      ->assertEquals('updated_presave', $node
      ->label(), 'Static cache has been cleared.');
  }

  /**
   * Tests saving a node on node insert.
   *
   * This test ensures that a node has been fully saved when
   * hook_ENTITY_TYPE_insert() is invoked, so that the node can be saved again
   * in a hook implementation without errors.
   *
   * @see node_test_node_insert()
   */
  public function testNodeSaveOnInsert() {

    // node_test_node_insert() triggers a save on insert if the title equals
    // 'new'.
    $node = $this
      ->drupalCreateNode([
      'title' => 'new',
    ]);
    $this
      ->assertEquals('Node ' . $node
      ->id(), $node
      ->getTitle(), 'Node saved on node insert.');
  }

}