W3cubDocs

/Web APIs

Window: moveBy() method

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨July 2015⁩.

The moveBy() method of the Window interface moves the current window by a specified amount.

Note: This function moves the window relative to its current location. In contrast, window.moveTo() moves the window to an absolute location.

Syntax

moveBy(deltaX, deltaY)

Parameters

deltaX: The amount of pixels to move the window horizontally. Positive values are to the right, while negative values are to the left.
deltaY: The amount of pixels to move the window vertically. Positive values are down, while negative values are up.

Return value

None (undefined).

Examples

This example moves the window 10 pixels to the right and 10 pixels up.

function budge() {
  moveBy(10, -10);
}

Specifications

Specification
CSSOM View Module> # dom-window-moveby>

Browser compatibility

	Desktop					Mobile
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari on IOS	Samsung Internet	WebView Android	WebView on iOS
`moveBy`	1	12	1	≤12.1	1	18	4	≤12.1	1	1.0	4.4	1

As of Firefox 7, websites can no longer move a browser window in the following cases:

You can't move a window or tab that wasn't created by Window.open().
You can't move a window or tab when it's in a window with more than one tab.

Note: This function might not move the window synchronously. In some environments (like Wayland, or mobile) it might not move the window at all. Currently there's no way to listen to a move event, see CSS Working Group issue #7693.